Parallel.Invoke Metoda

Definicja

Wykonuje każdą z podanych akcji, prawdopodobnie równolegle.Executes each of the provided actions, possibly in parallel.

Przeciążenia

Invoke(Action[])

Wykonuje każdą z podanych akcji, prawdopodobnie równolegle.Executes each of the provided actions, possibly in parallel.

Invoke(ParallelOptions, Action[])

Wykonuje każdą z podanych akcji, prawdopodobnie równolegle, chyba że operacja zostanie anulowana przez użytkownika.Executes each of the provided actions, possibly in parallel, unless the operation is cancelled by the user.

Invoke(Action[])

Wykonuje każdą z podanych akcji, prawdopodobnie równolegle.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())

Parametry

actions
Action[]

Tablica Action do wykonania.An array of Action to execute.

Wyjątki

actions argument jest null.The actions argument is null.

Wyjątek, który jest generowany, gdy jakakolwiek akcja w tablicy actions zgłasza wyjątek.The exception that is thrown when any action in the actions array throws an exception.

Tablica actions zawiera element null.The actions array contains a null element.

Przykłady

W tym przykładzie pokazano, jak używać metody Invoke z innymi metodami, anonimowymi delegatami i wyrażeniami lambda.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

Uwagi

Ta metoda może być używana do wykonywania zestawu operacji, potencjalnie równolegle.This method can be used to execute a set of operations, potentially in parallel.

Nie są wykonywane żadne gwarancje dotyczące kolejności wykonywania operacji lub wykonywania ich równolegle.No guarantees are made about the order in which the operations execute or whether they execute in parallel. Ta metoda nie jest zwracana do momentu ukończenia każdej z podanych operacji, niezależnie od tego, czy następuje zakończenie lub wyjątkowe zakończenie.This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

Aby uzyskać więcej informacji, zobacz How to: use Parallel. Invoke w celu wykonywania operacji równoległych.For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

Invoke(ParallelOptions, Action[])

Wykonuje każdą z podanych akcji, prawdopodobnie równolegle, chyba że operacja zostanie anulowana przez użytkownika.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

Parametry

parallelOptions
ParallelOptions

Obiekt, który konfiguruje zachowanie tej operacji.An object that configures the behavior of this operation.

actions
Action[]

Tablica akcji do wykonania.An array of actions to execute.

Wyjątki

CancellationToken w parallelOptions jest ustawiony.The CancellationToken in the parallelOptions is set.

actions argument jest null.The actions argument is null.

lub-or- parallelOptions argument jest null.The parallelOptions argument is null.

Wyjątek, który jest generowany, gdy jakakolwiek akcja w tablicy actions zgłasza wyjątek.The exception that is thrown when any action in the actions array throws an exception.

Tablica actions zawiera element null.The actions array contains a null element.

CancellationTokenSource skojarzone z CancellationToken w parallelOptions został usunięty.The CancellationTokenSource associated with the CancellationToken in the parallelOptions has been disposed.

Uwagi

Ta metoda może być używana do wykonywania zestawu operacji, potencjalnie równolegle.This method can be used to execute a set of operations, potentially in parallel. Token anulowania przeszedł przy użyciu struktury ParallelOptions umożliwia obiektowi wywołującemu anulowanie całej operacji.The cancellation token passed in with the ParallelOptions structure enables the caller to cancel the entire operation. Aby uzyskać więcej informacji, zobacz Anulowanie w zarządzanych wątkach.For more information, see Cancellation in Managed Threads.

Nie są wykonywane żadne gwarancje dotyczące kolejności wykonywania operacji lub wykonywania ich równolegle.No guarantees are made about the order in which the operations execute or whether they execute in parallel. Ta metoda nie jest zwracana do momentu ukończenia każdej z podanych operacji, niezależnie od tego, czy następuje zakończenie lub wyjątkowe zakończenie.This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

Aby uzyskać więcej informacji, zobacz How to: use Parallel. Invoke w celu wykonywania operacji równoległych.For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

Dotyczy