public static Task Finally(
	this Task task,
	Func<Task, Task> cleanupFunction
)

<ExtensionAttribute>
Public Shared Function Finally ( 
	task As Task,
	cleanupFunction As Func(Of Task, Task)
) As Task

public:
[ExtensionAttribute]
static Task^ Finally(
	Task^ task, 
	Func<Task^, Task^>^ cleanupFunction
)

[<ExtensionAttribute>]
static member Finally : 
        task : Task * 
        cleanupFunction : Func<Task, Task> -> Task 

Parameters

task

Type: System.Threading.TasksTask
The antecedent task.

cleanupFunction

Type: SystemFuncTask, Task
The continuation function to execute when task completes. The continuation function returns a Task representing the asynchronous cleanup operation.

Return Value

Usage Note

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

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

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 cleanupFunction is executed synchronously, this method should only be used for lightweight continuation functions. This restriction applies only to cleanupFunction itself, not to the Task returned by it.

.NET for Windows Store apps

.NET Framework

Portable Class Library

Threading Library

Reference