ContinueWhenAny(TAntecedentResult) Method (Task(TAntecedentResult)[], Action(Task(TAntecedentResult)), CancellationToken, TaskContinuationOptions, TaskScheduler)
TOC
Collapse the table of content
Expand the table of content

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.

Namespace:  System.Threading.Tasks
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).

Return Value

Type: System.Threading.Tasks.Task
The new continuation Task.

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

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2017 Microsoft