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