TaskFactory::ContinueWhenAny<TAntecedentResult> Method (array<Task<TAntecedentResult>^>^, Action<Task<TAntecedentResult>^>^, 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:
generic<typename TAntecedentResult>
Task^ ContinueWhenAny(
	array<Task<TAntecedentResult>^>^ tasks,
	Action<Task<TAntecedentResult>^>^ continuationAction,
	CancellationToken cancellationToken,
	TaskContinuationOptions continuationOptions,
	TaskScheduler^ scheduler
)

Parameters

tasks
Type: array<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.

Type Parameters

TAntecedentResult

The type of the result of the antecedent tasks.

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

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: