TaskFactory::ContinueWhenAny Method (array<Task^>^, Action<Task^>^, TaskContinuationOptions)
Creates a continuation Task that will be started upon the completion of any Task in the provided set.
Assembly: mscorlib (in mscorlib.dll)
public: Task^ ContinueWhenAny( array<Task^>^ tasks, Action<Task^>^ continuationAction, TaskContinuationOptions continuationOptions )
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.
- continuationOptions
-
Type:
System.Threading.Tasks::TaskContinuationOptions
The TaskContinuationOptions value that controls the behavior of the created continuation Task.
| Exception | Condition |
|---|---|
| ObjectDisposedException | The exception that is thrown when one of the elements in the tasks array has been disposed. |
| ArgumentNullException | The exception that is thrown when the tasks array is null. -or- The exception that is thrown when the continuationAction argument is null. |
| ArgumentOutOfRangeException | The exception that is thrown when the continuationOptions argument specifies an invalid TaskContinuationOptions value. |
| 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