CoreTaskExtensionsSelect Method (Task, ActionTask) |
Synchronously execute a continuation when a task completes successfully.
Namespace: Rackspace.ThreadingAssembly: Rackspace.Threading (in Rackspace.Threading.dll) Version: 1.1.0.0
Syntax
public static Task Select(
this Task task,
Action<Task> continuationAction
)
<ExtensionAttribute>
Public Shared Function Select (
task As Task,
continuationAction As Action(Of Task)
) As Task
public:
[ExtensionAttribute]
static Task^ Select(
Task^ task,
Action<Task^>^ continuationAction
)
[<ExtensionAttribute>]
static member Select :
task : Task *
continuationAction : Action<Task> -> Task
Parameters
- task
- Type: System.Threading.TasksTask
The antecedent task. - continuationAction
- Type: SystemActionTask
The continuation action to execute when task completes successfully.
Return Value
Type:
TaskA
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
Remarks
This code implements support for the following construct without requiring the use of
/
.
await task.ConfigureAwait(false);
continuationAction(task);
If the antecedent task is canceled or faulted, the status of the antecedent is
directly applied to the task returned by this method; it 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 actions. For non-trivial continuation actions, use a
Task for the continuation operation and call
Then(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