This documentation is archived and is not being maintained.

Parallel::Invoke Method (ParallelOptions, array<Action>)

Executes each of the provided actions, possibly in parallel, unless the operation is cancelled by the user.

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

static void Invoke(
	ParallelOptions^ parallelOptions, 
	... array<Action^>^ actions


Type: System.Threading.Tasks::ParallelOptions
An object that configures the behavior of this operation.
Type: array<System::Action>
An array of actions to execute.


The CancellationToken in the parallelOptions is set.


The actions argument is nullptr.


The parallelOptions argument is nullptr.


The exception that is thrown when any action in the actions array throws an exception.


The actions array contains a nullptr element.


The CancellationTokenSource associated with the CancellationToken in the parallelOptions has been disposed.

This method can be used to execute a set of operations, potentially in parallel. The cancellation token passed in with the ParallelOptions structure enables the caller to cancel the entire operation. For more information, see Cancellation.

No guarantees are made about the order in which the operations execute or whether they execute in parallel. This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

.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.