ContinueWhenAny Method (Task[], Func(Task, TResult), CancellationToken)

TaskFactory(Of TResult).ContinueWhenAny Method (Task(), Func(Of Task, TResult), CancellationToken)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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)

'Declaration
Public Function ContinueWhenAny ( _
	tasks As Task(), _
	continuationFunction As Func(Of Task, TResult), _
	cancellationToken As CancellationToken _
) As Task(Of TResult)

Parameters

tasks
Type: System.Threading.Tasks.Task ()
The array of tasks from which to continue when one task completes.
continuationFunction
Type: System.Func(Of Task, TResult)
The function delegate to execute asynchronously when one task in the tasks array completes.
cancellationToken
Type: System.Threading.CancellationToken
The cancellation token that will be assigned to the new continuation task.

Return Value

Type: System.Threading.Tasks.Task(Of TResult)
The new continuation task.

ExceptionCondition
ObjectDisposedException

One of the elements in the tasks array has been disposed.

-or-

The CancellationTokenSource that created cancellationToken has already been disposed.

ArgumentNullException

The tasks array is null.

-or-

The continuationFunction argument is null.

ArgumentException

The tasks array contains a null value.

-or-

The tasks array is empty.

After completion, a task is in one of these states: RanToCompletion, Faulted, or Canceled states.

Windows Phone OS

Supported in: 8.1, 8.0

Date

History

Reason

Added text to clarify asynchronous execution of continuations.

Customer feedback.

Show:
© 2017 Microsoft