Click or drag to resize
CoreTaskExtensionsFinally Method (Task, ActionTask)
Synchronously execute a cleanup continuation when a task completes, regardless of the final Status of the task. If the cleanup action completes successfully, the status of the antecedent is directly applied to the task returned by this method. Otherwise, the status of the faulted or canceled cleanup operation is directly applied to the task returned by this method.

Namespace: Rackspace.Threading
Assembly: Rackspace.Threading (in Rackspace.Threading.dll) Version: 2.1.0-beta1
Syntax
public static Task Finally(
	this Task task,
	Action<Task> cleanupAction
)

Parameters

task
Type: System.Threading.TasksTask
The antecedent task.
cleanupAction
Type: SystemActionTask
The cleanup continuation function to execute when task completes.

Return Value

Type: Task
A Task representing the asynchronous operation.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type Task. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Exceptions
ExceptionCondition
ArgumentNullException

If task is .

-or-

If cleanupAction is .

Remarks

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

C#
try
{
    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.

Note 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.

Version Information

.NET for Windows Store apps

Supported in: Windows 8

.NET Framework

Supported in: 4.5, 4.0, 3.5

Portable Class Library

Supported in: Portable Class Library (Legacy), Portable Class Library

Threading Library

Supported in: 2.1, 2.0, 1.1, 1.0
See Also