Export (0) Print
Expand All
Expand Minimize

TaskFactory.ContinueWhenAll Method (Task[], Action<Task[]>)

Creates a continuation task that will be started upon the completion of a set of provided tasks.

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

public Task ContinueWhenAll(
	Task[] tasks,
	Action<Task[]> continuationAction
)

Parameters

tasks
Type: System.Threading.Tasks.Task[]
The array of tasks from which to continue.
continuationAction
Type: System.Action<Task[]>
The action delegate to execute when all tasks in the tasks array have completed.

Return Value

Type: System.Threading.Tasks.Task
The new continuation task.

ExceptionCondition
ObjectDisposedException

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

ArgumentNullException

The tasks array is null.

-or-

The continuationAction argument is null.

ArgumentException

The tasks array contains a null value.

-or-

The tasks array is empty.

This example demonstrates using ContinueWhenAll() to perform some continuation a set of previously started Tasks has completed.

// C#

// Create and start some tasks

var taskQueue = new Queue<Task>();

for (int i = 0; i < 10; i++)

{

taskQueue.Enqueue(Task.Factory.StartNew(() =>

{

// Do work.

}));

}

// Perform some work with the tasks when they complete.

Task.Factory.ContinueWhenAll(taskQueue.ToArray(), completedTasks =>

{

// Do continuation work.

});

' Visual Basic

' Create and start some tasks

Dim taskQueue As New Queue(Of Task)()

For i As Integer = 0 To 9

taskQueue.Add(Task.Factory.StartNew(Sub()

' Do work.

End Sub))

Next

' Perform some work with the tasks when they complete.

Task.Factory.ContinueWhenAll(taskQueue.ToArray(), Sub(completedTasks)

' Do continuation work.

End Sub)

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft