TaskFactory::ContinueWhenAny Method (array<Task^>^, Action<Task^>^, CancellationToken, TaskContinuationOptions, TaskScheduler^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Parameters

tasks
Type: array<System.Threading.Tasks::Task^>^

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

continuationAction
Type: System::Action<Task^>^

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.

Return Value

Type: System.Threading.Tasks::Task^

The new continuation Task.

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.

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: