TaskFactory.ContinueWhenAny Method (array<Task[], Action<Task>, TaskContinuationOptions)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Creates a continuation Task that will be started upon the completion of any Task in the provided set.
Namespace: System.Threading.Tasks
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function ContinueWhenAny ( _
tasks As Task(), _
continuationAction As Action(Of Task), _
continuationOptions As TaskContinuationOptions _
) As Task
public Task ContinueWhenAny(
Task[] tasks,
Action<Task> continuationAction,
TaskContinuationOptions continuationOptions
)
Parameters
- tasks
Type: array<System.Threading.Tasks.Task[]
The array of tasks from which to continue when one task completes.
- continuationAction
Type: System.Action<Task>
The action delegate to execute when one task in the tasks array completes.
- continuationOptions
Type: System.Threading.Tasks.TaskContinuationOptions
The TaskContinuationOptions value that controls the behavior of the created continuation Task.
Return Value
Type: System.Threading.Tasks.Task
The new continuation Task.
Exceptions
Exception | Condition |
---|---|
ObjectDisposedException | The exception that is thrown when one of the elements in the tasks array has been disposed. |
ArgumentNullException | The exception that is thrown when the tasks array is null. -or- The exception that is thrown when the continuationAction argument is null. |
ArgumentOutOfRangeException | The exception that is thrown when the continuationOptions argument specifies an invalid TaskContinuationOptions value. |
ArgumentException | The exception that is thrown when the tasks array contains a null value. -or- The exception that is thrown when the tasks array is empty. |
Remarks
The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAny.
Version Information
Silverlight
Supported in: 5
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also