But you can also setup globally your own error handler with the TaskMonitorConfiguration static class:

Now careful: if you are in a MVVM scenario, I strongly encourage you to read my Free Yourself From IsBusy post. The ViewModelLoader or the NotifyTask would be better to handle the ViewModel loading states.

Features summary

Delegates for all states of the ran task:

Builder for more elegant construction and deferred execution:

Support for task with result, Task<T>:

Default handling of errors and statistics, and naming of the monitor:

Output:

Global configuration for statistics and errors handlers:

Run the wrapped Task in a new Task:

Await the task monitor without failures. Awaiting on the TaskCompleted property will never fail:

Consider globally or locally the cancel state as faulted to simplify your workflow:

Other common scenarios

Good with events or messages

If you are subscribing to an event/message and want to make async stuff when the event is raised, it will also be a perfect candidate.

Good with non awaited task and ContinueWith

Previously you maybe used the ContinueWith task method to create a new task and deal with fire and forget scenarios.

You can achieve the same behaviour with the TaskMonitor in a cleaner way:

Can be used as a simple decorator for statistics and error handling

You can specify global error handler and statistics logger:

Then use TaskMonitor as a simple task logging decorator:

But you can also let the default handlers Trace the errors and the statistics. Output with default handlers:

Origins

The TaskMonitor was inspired by Stephen Cleary's NotifyTask. It's a task wrapper dealing with non-awaited, or fire and forget if you prefer, Task. The difference is that NotifyTask is made for UI scenarios (MVVM), where you want to bind the result or the state of the task to a view property. For this it implements INotifyPropertyChanged. See this: https://docs.microsoft.com/en-us/archive/msdn-magazine/2013/march/async-await-best-practices-in-asynchronous-programming

Whereas TaskMonitor is designed to be used in any kind of scenarios (server, business layer, UI, etc...).