Export (0) Print
Expand All
Expand Minimize

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

Creates a continuation Task<TResult> that will be started upon the completion of any Task in the provided set.

Namespace:  System.Threading.Tasks
Assemblies:   mscorlib (in mscorlib.dll)
  System.Threading.Tasks (in System.Threading.Tasks.dll)

public Task<TResult> ContinueWhenAny<TResult>(
	Task[] tasks,
	Func<Task, TResult> continuationFunction,
	CancellationToken cancellationToken,
	TaskContinuationOptions continuationOptions,
	TaskScheduler scheduler
)

Type Parameters

TResult

The type of the result that is returned by the continuationFunction delegate and associated with the created Task<TResult>.

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

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<TResult>
The new continuation Task<TResult>.

ExceptionCondition
ArgumentNullException

The exception that is thrown when the tasks array is null.

-or-

The exception that is thrown when the continuationFunction 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.

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft