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

Definizione

Esegue ognuna delle azioni fornite, eventualmente in parallelo.Executes each of the provided actions, possibly in parallel.

Overload

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

Esegue ognuna delle azioni fornite, eventualmente in parallelo.Executes each of the provided actions, possibly in parallel.

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

Esegue ciascuna delle azioni fornite, possibilmente in parallelo, a meno che l'operazione non venga annullata dall'utente.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[])

Esegue ognuna delle azioni fornite, eventualmente in parallelo.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())

Parametri

actions
Action[]

Matrice di Action da eseguire.An array of Action to execute.

Eccezioni

Il valore dell'argomento actions è null.The actions argument is null.

L'eccezione generata quando qualsiasi azione nella actions matrice genera un'eccezione.The exception that is thrown when any action in the actions array throws an exception.

Il actions matrice contiene un null elemento.The actions array contains a null element.

Esempi

In questo esempio viene illustrato come utilizzare il Invoke metodo con altri metodi, delegati anonimi ed espressioni 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

Commenti

Questo metodo può essere utilizzato per eseguire una serie di operazioni, potenzialmente in parallelo.This method can be used to execute a set of operations, potentially in parallel.

Non sono garanzie sull'ordine in cui eseguire le operazioni o se vengono eseguite in parallelo.No guarantees are made about the order in which the operations execute or whether they execute in parallel. Questo metodo non restituisce fino a quando ognuna delle operazioni fornite è completata, indipendentemente dal fatto che il completamento si verifica a causa di chiusura normale o insolita.This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

Per altre informazioni, vedere Procedura: Usare Parallel.Invoke per eseguire operazioni in parallelo.For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

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

Esegue ciascuna delle azioni fornite, possibilmente in parallelo, a meno che l'operazione non venga annullata dall'utente.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

Parametri

parallelOptions
ParallelOptions ParallelOptions ParallelOptions ParallelOptions

Oggetto che configura il comportamento di questa operazione.An object that configures the behavior of this operation.

actions
Action[]

Matrice di azioni da eseguire.An array of actions to execute.

Eccezioni

Il valore dell'argomento actions è null.The actions argument is null.

-oppure--or- Il valore dell'argomento parallelOptions è null.The parallelOptions argument is null.

L'eccezione generata quando qualsiasi azione nella actions matrice genera un'eccezione.The exception that is thrown when any action in the actions array throws an exception.

Il actions matrice contiene un null elemento.The actions array contains a null element.

Il CancellationTokenSource associato con il CancellationToken nel parallelOptions byla zahozena.The CancellationTokenSource associated with the CancellationToken in the parallelOptions has been disposed.

Commenti

Questo metodo può essere utilizzato per eseguire una serie di operazioni, potenzialmente in parallelo.This method can be used to execute a set of operations, potentially in parallel. Il token di annullamento passato con la ParallelOptions struttura consente al chiamante annullare l'intera operazione.The cancellation token passed in with the ParallelOptions structure enables the caller to cancel the entire operation. Per altre informazioni, vedere Annullamento in thread gestiti.For more information, see Cancellation in Managed Threads.

Non sono garanzie sull'ordine in cui eseguire le operazioni o se vengono eseguite in parallelo.No guarantees are made about the order in which the operations execute or whether they execute in parallel. Questo metodo non restituisce fino a quando ognuna delle operazioni fornite è completata, indipendentemente dal fatto che il completamento si verifica a causa di chiusura normale o insolita.This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

Per altre informazioni, vedere Procedura: Usare Parallel.Invoke per eseguire operazioni in parallelo.For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

Si applica a