TaskFactory::ContinueWhenAll Method (array<Task>, Action<array<Task>>)
Creates a continuation task that starts when a set of specified tasks has completed.
Assemblies: mscorlib (in mscorlib.dll)
System.Threading.Tasks (in System.Threading.Tasks.dll)
public: Task^ ContinueWhenAll( array<Task^>^ tasks, Action<array<Task^>^>^ continuationAction )
- Type: array<System.Threading.Tasks::Task>
The array of tasks from which to continue.
Return ValueType: System.Threading.Tasks::Task
The new continuation task.
The ContinueWhenAll method executes the continuationAction delegate when all tasks in the tasks array have completed, regardless of their completion status.
Exceptions thrown by tasks in the tasks array are not available to the continuation task through structured exception handling. You can determine which exceptions were thrown by examining the Task::Exception property of each task in the tasks array. To use structured exception handling to handle exceptions thrown by tasks in the tasks array, call the Task::WaitAll(array<Task>) method.
The following example launches separate tasks that use a regular expression to count the number of words in a set of text files. The ContinueWhenAll method is used to launch a task that displays the total word count when all the antecedent tasks have completed.
The call to the continuation task's Task::Wait method does not allow it to handle exceptions thrown by the antecedent tasks, so the example examines the Task::Status property of each antecedent task to determine whether the task succeeded.
.NET FrameworkSupported in: 4.6, 4.5, 4
.NET Framework Client ProfileSupported in: 4
Portable Class LibrarySupported in: Portable Class Library
.NET for Windows Store appsSupported in: Windows 8
Supported in: Windows Phone 8.1
Supported in: Windows Phone Silverlight 8.1
Supported in: Windows Phone Silverlight 8
Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.