CoreTaskExtensionsFinallyTResult Method (TaskTResult, ActionTaskTResult) |
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.ThreadingAssembly: Rackspace.Threading (in Rackspace.Threading.dll) Version: 1.1.0.0
Syntax
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
Type:
TaskTResultA
Task representing the asynchronous operation. When the task
completes successfully, the
Result property will return
the result of the antecedent
task.
Usage Note
In Visual Basic and C#, you can call this method as an instance method on any object of type
TaskTResult. 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
Remarks
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.
|
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
Rackspace Threading Library
Supported in: 1.1, 1.0
See Also