WhenAll(TResult) Method (Task(TResult)[])
Collapse the table of content
Expand the table of content

Task.WhenAll(Of TResult) Method (Task(Of TResult)())

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

Creates a task that will complete when all of the supplied tasks have completed.

Namespace:  System.Threading.Tasks
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
Public Shared Function WhenAll(Of TResult) ( _
	ParamArray tasks As Task(Of TResult)() _
) As Task(Of TResult())

Type Parameters

TResult

The type of the completed task.

Parameters

tasks
Type: System.Threading.Tasks.Task(Of TResult) ()
The tasks to wait on for completion.

Return Value

Type: System.Threading.Tasks.Task(Of TResult ())
A task that represents the completion of all of the supplied tasks.

ExceptionCondition
ArgumentNullException

The tasks argument was null.

ArgumentException

The tasks array contained a null task.

If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state, where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.

If none of the supplied tasks faulted but at least one of them was canceled, the returned task will end in the Canceled state.

If none of the tasks faulted and none of the tasks were canceled, the resulting task will end in the RanToCompletion state. The Result of the returned task will be set to an array containing all of the results of the supplied tasks in the same order as they were provided (e.g. if the input tasks array contained t1, t2, t3, the output task's Result will return an TResult[] where arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result).

If the supplied array/enumerable contains no tasks, the returned task will immediately transition to a RanToCompletion state before it's returned to the caller. The returned TResult[] will be an array of 0 elements.

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2017 Microsoft