TaskFactory.ContinueWhenAny(Of TAntecedentResult) Method (Task(Of TAntecedentResult)(), Action(Of Task(Of TAntecedentResult)), CancellationToken, TaskContinuationOptions, TaskScheduler)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Creates a continuation Task that will be started upon the completion of any Task in the provided set.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Function ContinueWhenAny(Of TAntecedentResult) ( _ tasks As Task(Of TAntecedentResult)(), _ continuationAction As Action(Of Task(Of TAntecedentResult)), _ cancellationToken As CancellationToken, _ continuationOptions As TaskContinuationOptions, _ scheduler As TaskScheduler _ ) As Task
Type Parameters
- TAntecedentResult
The type of the result of the antecedent tasks.
Parameters
- tasks
- Type:
System.Threading.Tasks.Task(Of TAntecedentResult)
()
The array of tasks from which to continue when one task completes.
- continuationAction
- Type: System.Action(Of Task(Of TAntecedentResult))
The action delegate to execute when one task in the tasks array completes.
- cancellationToken
- Type: System.Threading.CancellationToken
The CancellationToken that will be assigned to the new continuation task.
- continuationOptions
- Type: System.Threading.Tasks.TaskContinuationOptions
The TaskContinuationOptions value that controls the behavior of the created continuation Task.
- scheduler
- Type: System.Threading.Tasks.TaskScheduler
The TaskScheduler that is used to schedule the created continuation Task(Of TResult).
| Exception | Condition |
|---|---|
| ArgumentNullException | The exception that is thrown when the tasks array is null. -or- The exception that is thrown when the continuationAction argument is null. -or- The exception that is thrown when the scheduler argument is null. |
| 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. |
The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAny.