public static Task<TResult> Catch<TException, TResult>(
	this Task<TResult> task,
	Predicate<TException> filter,
	Func<Task<TResult>, TException, TResult> handler
)
where TException : Exception

<ExtensionAttribute>
Public Shared Function Catch(Of TException As Exception, TResult) ( 
	task As Task(Of TResult),
	filter As Predicate(Of TException),
	handler As Func(Of Task(Of TResult), TException, TResult)
) As Task(Of TResult)

public:
[ExtensionAttribute]
generic<typename TException, typename TResult>
where TException : Exception
static Task<TResult>^ Catch(
	Task<TResult>^ task, 
	Predicate<TException>^ filter, 
	Func<Task<TResult>^, TException, TResult>^ handler
)

[<ExtensionAttribute>]
static member Catch : 
        task : Task<'TResult> * 
        filter : Predicate<'TException> * 
        handler : Func<Task<'TResult>, 'TException, 'TResult> -> Task<'TResult>  when 'TException : Exception

Parameters

task

Type: System.Threading.Tasks.Task<TResult>
The antecedent task.

filter

Type: System.Predicate<TException>
A predicate defining the condition under which the exception is handled.

handler

Type: System.Func<Task<TResult>, TException, TResult>
The exception handler continuation function to execute when task completes with an exception of type TException.

Type Parameters

TException

The type of exception which is handled by handler.

TResult

The result type of the antecedent task.

Return Value

Usage Note

This code implements support for the following construct without requiring the use of async/await.

try
{
    return await task.ConfigureAwait(false);
}
catch (TException ex) when (filter(ex))
{
    return handler(task, ex);
}

This method is capable of handling Canceled antecedent tasks when TException is assignable from TaskCanceledException.

This method ensures that exception information provided by a faulted or canceled task is not wrapped in an additional AggregateException.

Notes to Callers
Since the continuation is executed synchronously, this method should only be used for lightweight exception handler methods. For non-trivial exception handlers, use a Task for the exception handling operation and call Catch<TException, TResult>(Task<TResult>, Predicate<TException>, Func<Task<TResult>, TException, Task<TResult>>) instead.

.NET for Windows Store apps

.NET Framework

Portable Class Library

Threading Library

Reference