TaskFactory<TResult>::ContinueWhenAll Method (array<Task^>^, Func<array<Task^>^, TResult>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)

.NET Framework (current version)

Creates a continuation task that will be started upon the completion of a set of provided Tasks.

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

Syntax

public:
Task<TResult>^ ContinueWhenAll(
	array<Task^>^ tasks,
	Func<array<Task^>^, TResult>^ continuationFunction,
	CancellationToken cancellationToken,
	TaskContinuationOptions continuationOptions,
	TaskScheduler^ scheduler
)

Parameters

tasks: Type: array<System.Threading.Tasks::Task^>^
The array of tasks from which to continue.

continuationFunction: Type: System::Func<array<Task^>^, TResult>^
The function delegate to execute asynchronously when all tasks in the tasks array have completed.

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 scheduler that is used to schedule the created continuation task.

Return Value

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

The new continuation task.

Exceptions

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 is empty.
ArgumentOutOfRangeException	continuationOptions specifies an invalid value.
ObjectDisposedException	One of the elements in the tasks array has been disposed. -or- The CancellationTokenSource that created cancellationToken has already been disposed.

Remarks

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