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

 

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

Parameters

tasks
Type: System.Threading.Tasks.Task<TAntecedentResult>[]

The array of tasks from which to continue when one task completes.

continuationFunction
Type: System.Func<Task<TAntecedentResult>, 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 TaskScheduler that is used to schedule the created continuation Task<TResult>.

Return Value

Type: System.Threading.Tasks.Task<TResult>

The new continuation Task<TResult>.

Type Parameters

TAntecedentResult

The type of the result of the antecedent tasks.

Exception Condition
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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 5.0
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Return to top
Show: