Parallel.Invoke Parallel.Invoke Parallel.Invoke Parallel.Invoke Method

Definition

Führt jede der bereitgestellten Aktionen aus (möglicherweise parallel).Executes each of the provided actions, possibly in parallel.

Überlädt

Invoke(Action[]) Invoke(Action[]) Invoke(Action[]) Invoke(Action[])

Führt jede der bereitgestellten Aktionen aus (möglicherweise parallel).Executes each of the provided actions, possibly in parallel.

Invoke(ParallelOptions, Action[]) Invoke(ParallelOptions, Action[]) Invoke(ParallelOptions, Action[])

Führt die einzelnen bereitgestellten Aktionen (nach Möglichkeit parallel) aus, es sei denn, der Vorgang wird vom Benutzer abgebrochen.Executes each of the provided actions, possibly in parallel, unless the operation is cancelled by the user.

Invoke(Action[]) Invoke(Action[]) Invoke(Action[]) Invoke(Action[])

Führt jede der bereitgestellten Aktionen aus (möglicherweise parallel).Executes each of the provided actions, possibly in parallel.

public:
 static void Invoke(... cli::array <Action ^> ^ actions);
public static void Invoke (params Action[] actions);
static member Invoke : Action[] -> unit
Public Shared Sub Invoke (ParamArray actions As Action())

Parameter

actions
Action[]

Ein Array auszuführender Action.An array of Action to execute.

Ausnahmen

Das actions-Argument lautet null.The actions argument is null.

Diese Ausnahme wird ausgelöst, wenn eine beliebige Aktion im actions-Array eine Ausnahme auslöst.The exception that is thrown when any action in the actions array throws an exception.

Ein actions-Array enthält ein null-Element.The actions array contains a null element.

Beispiele

In diesem Beispiel wird veranschaulicht, wie Invoke die-Methode mit anderen Methoden, anonymen Delegaten und Lambda-Ausdrücken verwendet wird.This example demonstrates how to use the Invoke method with other methods, anonymous delegates, and lambda expressions.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;

    class ParallelInvokeDemo
    {

        // Demonstrated features:
        // 		Parallel.Invoke()
        // Expected results:
        // 		The threads on which each task gets executed may be different.
        //		The thread assignments may be different in different executions.
        //		The tasks may get executed in any order.
        // Documentation:
        //		http://msdn.microsoft.com/library/dd783942(VS.100).aspx
        static void Main()
        {
            try
            {
                Parallel.Invoke(
                    BasicAction,	// Param #0 - static method
                    () =>			// Param #1 - lambda expression
                    {
                        Console.WriteLine("Method=beta, Thread={0}", Thread.CurrentThread.ManagedThreadId);
                    },
                    delegate()		// Param #2 - in-line delegate
                    {
                        Console.WriteLine("Method=gamma, Thread={0}", Thread.CurrentThread.ManagedThreadId);
                    }
                );
            }
            // No exception is expected in this example, but if one is still thrown from a task,
            // it will be wrapped in AggregateException and propagated to the main thread.
            catch (AggregateException e)
            {
                Console.WriteLine("An action has thrown an exception. THIS WAS UNEXPECTED.\n{0}", e.InnerException.ToString());
            }
        }

        static void BasicAction()
        {
            Console.WriteLine("Method=alpha, Thread={0}", Thread.CurrentThread.ManagedThreadId);
        }


    }
Imports System.Threading
Imports System.Threading.Tasks

Module InvokeDemo

    ' Demonstrated features:
    '   Parallel.Invoke()
    ' Expected results:
    '   The threads on which each task gets executed may be different.
    '   The thread assignments may be different in different executions.
    '   The tasks may get executed in any order.
    ' Documentation:
    '   http://msdn.microsoft.com/library/dd783942(VS.100).aspx
    Private Sub Main()
        Try
            ' Param #0 - static method
            Parallel.Invoke(AddressOf BasicAction,
                            Sub()
                                ' Param #1 - lambda expression
                                Console.WriteLine("Method=beta, Thread={0}", Thread.CurrentThread.ManagedThreadId)
                            End Sub,
                            Sub()
                                ' Param #2 - in-line delegate
                                Console.WriteLine("Method=gamma, Thread={0}", Thread.CurrentThread.ManagedThreadId)
                            End Sub)
        Catch e As AggregateException
            ' No exception is expected in this example, but if one is still thrown from a task,
            ' it will be wrapped in AggregateException and propagated to the main thread.
            Console.WriteLine("An action has thrown an exception. THIS WAS UNEXPECTED." & vbLf & "{0}", e.InnerException.ToString())
        End Try
    End Sub

    Private Sub BasicAction()
        Console.WriteLine("Method=alpha, Thread={0}", Thread.CurrentThread.ManagedThreadId)
    End Sub



End Module

Hinweise

Diese Methode kann verwendet werden, um eine Reihe von Vorgängen (möglicherweise parallel) auszuführen.This method can be used to execute a set of operations, potentially in parallel.

Die Reihenfolge, in der die Vorgänge ausgeführt werden, oder ob Sie parallel ausgeführt werden, wird nicht garantiert.No guarantees are made about the order in which the operations execute or whether they execute in parallel. Diese Methode gibt nicht zurück, bis alle bereitgestellten Vorgänge abgeschlossen sind, unabhängig davon, ob die Beendigung aufgrund der normalen oder außergewöhnlichen Beendigung erfolgt.This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

Weitere Informationen finden Sie unter Gewusst wie: Ausführen von parallelen Aufgaben mithilfe von Parallel.Invoke.For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

Invoke(ParallelOptions, Action[]) Invoke(ParallelOptions, Action[]) Invoke(ParallelOptions, Action[])

Führt die einzelnen bereitgestellten Aktionen (nach Möglichkeit parallel) aus, es sei denn, der Vorgang wird vom Benutzer abgebrochen.Executes each of the provided actions, possibly in parallel, unless the operation is cancelled by the user.

public:
 static void Invoke(System::Threading::Tasks::ParallelOptions ^ parallelOptions, ... cli::array <Action ^> ^ actions);
public static void Invoke (System.Threading.Tasks.ParallelOptions parallelOptions, params Action[] actions);
static member Invoke : System.Threading.Tasks.ParallelOptions * Action[] -> unit

Parameter

parallelOptions
ParallelOptions ParallelOptions ParallelOptions ParallelOptions

Ein Objekt, das das Verhalten dieses Vorgangs konfiguriert.An object that configures the behavior of this operation.

actions
Action[]

Ein Array auszuführender Aktionen.An array of actions to execute.

Ausnahmen

Das actions-Argument lautet null.The actions argument is null.

- oder --or- Das parallelOptions-Argument lautet null.The parallelOptions argument is null.

Diese Ausnahme wird ausgelöst, wenn eine beliebige Aktion im actions-Array eine Ausnahme auslöst.The exception that is thrown when any action in the actions array throws an exception.

Ein actions-Array enthält ein null-Element.The actions array contains a null element.

Die CancellationTokenSource, die der CancellationToken im parallelOptions zugeordnet ist, ist gelöscht worden.The CancellationTokenSource associated with the CancellationToken in the parallelOptions has been disposed.

Hinweise

Diese Methode kann verwendet werden, um eine Reihe von Vorgängen (möglicherweise parallel) auszuführen.This method can be used to execute a set of operations, potentially in parallel. Das mit der ParallelOptions -Struktur übergebenen Abbruch Token ermöglicht dem Aufrufer, den gesamten Vorgang abzubrechen.The cancellation token passed in with the ParallelOptions structure enables the caller to cancel the entire operation. Weitere Informationen finden Sie unter Abbruch in verwalteten Threads.For more information, see Cancellation in Managed Threads.

Die Reihenfolge, in der die Vorgänge ausgeführt werden, oder ob Sie parallel ausgeführt werden, wird nicht garantiert.No guarantees are made about the order in which the operations execute or whether they execute in parallel. Diese Methode gibt nicht zurück, bis alle bereitgestellten Vorgänge abgeschlossen sind, unabhängig davon, ob die Beendigung aufgrund der normalen oder außergewöhnlichen Beendigung erfolgt.This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

Weitere Informationen finden Sie unter Gewusst wie: Ausführen von parallelen Aufgaben mithilfe von Parallel.Invoke.For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

Gilt für: