TaskFactory::ContinueWhenAny<TResult> Method (array<Task^>^, Func<Task^, TResult>^, CancellationToken)

 
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<TResult> 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 TResult>
Task<TResult>^ ContinueWhenAny(
	array<Task^>^ tasks,
	Func<Task^, TResult>^ continuationFunction,
	CancellationToken cancellationToken
)

Parameters

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

Return Value

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

The new continuation Task<TResult>.

Type Parameters

TResult

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

Exception Condition
ObjectDisposedException

The exception that is thrown when one of the elements in the tasks array has been disposed.

-or-

The provided CancellationToken has already been disposed.

ArgumentNullException

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

-or-

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