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

TaskFactory.ContinueWhenAny<TAntecedentResult> Method (Task<TAntecedentResult>[], Action<Task<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)

public Task ContinueWhenAny<TAntecedentResult>(
	Task<TAntecedentResult>[] tasks,
	Action<Task<TAntecedentResult>> continuationAction,
	CancellationToken cancellationToken,
	TaskContinuationOptions continuationOptions,
	TaskScheduler scheduler
)

Type Parameters

TAntecedentResult

The type of the result of the antecedent tasks.

Parameters

tasks
Type: System.Threading.Tasks.Task<TAntecedentResult> []
The array of tasks from which to continue when one task completes.
continuationAction
Type: System.Action<Task<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<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:
© 2016 Microsoft