public static Task<TResult> Finally<TResult>(
	this Task<TResult> task,
	Action<Task<TResult>> cleanupAction
)

<ExtensionAttribute>
Public Shared Function Finally(Of TResult) ( 
	task As Task(Of TResult),
	cleanupAction As Action(Of Task(Of TResult))
) As Task(Of TResult)

public:
[ExtensionAttribute]
generic<typename TResult>
static Task<TResult>^ Finally(
	Task<TResult>^ task, 
	Action<Task<TResult>^>^ cleanupAction
)

[<ExtensionAttribute>]
static member Finally : 
        task : Task<'TResult> * 
        cleanupAction : Action<Task<'TResult>> -> Task<'TResult> 

Parameters

task

Type: System.Threading.TasksTaskTResult
The antecedent task.

cleanupAction

Type: SystemActionTaskTResult
The cleanup continuation function to execute when task completes.

Type Parameters

TResult

The type of the result produced by the antecedent TaskTResult.

Return Value

Usage Note

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

try
{
    return await task.ConfigureAwait(false);
}
finally
{
    cleanupAction(task);
}

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 continuation functions. For non-trivial continuation functions, use a Task for the continuation operation and call Finally(Task, FuncTask, Task) instead.

.NET for Windows Store apps

.NET Framework

Portable Class Library

Threading Library

Reference