This topic has not yet been rated - Rate this topic

TaskFactory<TResult>.ContinueWhenAny Method (Task[], Func<Task, TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

April 12, 2014

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<TResult> ContinueWhenAny(
	Task[] tasks,
	Func<Task, TResult> continuationFunction,
	CancellationToken cancellationToken,
	TaskContinuationOptions continuationOptions,
	TaskScheduler scheduler
)

Parameters

tasks
Type: System.Threading.Tasks.Task []
The array of tasks from which to continue when one task completes.
continuationFunction
Type: System.Func<Task, TResult>
The function delegate to execute asynchronously when one task in the tasks array completes.
cancellationToken
Type: System.Threading.CancellationToken
The cancellation token that will be assigned to the new continuation task.
continuationOptions
Type: System.Threading.Tasks.TaskContinuationOptions
One of the enumeration values that controls the behavior of the created continuation task. The NotOn* or OnlyOn* values are not valid.
scheduler
Type: System.Threading.Tasks.TaskScheduler
The task scheduler that is used to schedule the created continuation task.

Return Value

Type: System.Threading.Tasks.Task<TResult>
The new continuation task.
ExceptionCondition
ArgumentNullException

The tasks array is null.

-or-

The continuationFunction argument is null.

-or-

The scheduler argument is null.

ArgumentException

The tasks array contains a null value.

-or-

The tasks array is empty.

ArgumentOutOfRangeException

The continuationOptions argument specifies an invalid TaskContinuationOptions value.

ObjectDisposedException

One of the elements in the tasks array has been disposed.

-or-

The CancellationTokenSource that created cancellationToken has already been disposed.

After completion, a task is in one of these states: RanToCompletion, Faulted, or Canceled states.

Windows Phone OS

Supported in: 8.1, 8.0

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.