Parallel.Invoke Méthode

Référence

Définition

Espace de noms:: System.Threading.Tasks

Assembly:: System.Threading.Tasks.Parallel.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Exécute chacune des actions fournies, éventuellement en parallèle.

Surcharges

Invoke(Action[])	Exécute chacune des actions fournies, éventuellement en parallèle.
Invoke(ParallelOptions, Action[])	Exécute chacune des actions fournies, éventuellement en parallèle, sauf si l'opération est annulée par l'utilisateur.

Invoke(Action[])

Exécute chacune des actions fournies, éventuellement en parallèle.

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())

Paramètres

actions: Action[]

Tableau de Action à exécuter.

Exceptions

ArgumentNullException

L'argument actions a la valeur null.

AggregateException

L'exception levée lorsque toute action dans le tableau actions lève une exception.

ArgumentException

Le tableau actions contient un élément null.

Exemples

Cet exemple montre comment utiliser la Invoke méthode avec d’autres méthodes, délégués anonymes et expressions lambda.

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

Remarques

Cette méthode peut être utilisée pour exécuter un ensemble d’opérations, potentiellement en parallèle.

Aucune garantie n’est faite sur l’ordre dans lequel les opérations s’exécutent ou si elles s’exécutent en parallèle. Cette méthode ne retourne pas tant que chacune des opérations fournies n’est pas terminée, qu’elle se produise ou non en raison d’un arrêt normal ou exceptionnel.

Pour plus d’informations, consultez Comment : utiliser parallel_invoke pour exécuter des opérations parallèles.

S’applique à

Invoke(ParallelOptions, Action[])

Exécute chacune des actions fournies, éventuellement en parallèle, sauf si l'opération est annulée par l'utilisateur.

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

Public Shared Sub Invoke (parallelOptions As ParallelOptions, ParamArray actions As Action())

Paramètres

parallelOptions: ParallelOptions

Objet qui configure le comportement de cette opération.

actions: Action[]

Tableau d'actions à exécuter.

Exceptions

OperationCanceledException

Objet CancellationToken dans parallelOptions est défini.

ArgumentNullException

L'argument actions a la valeur null.

ou - L'argument parallelOptions a la valeur null.

AggregateException

L'exception levée lorsque toute action dans le tableau actions lève une exception.

ArgumentException

Le tableau actions contient un élément null.

ObjectDisposedException

Objet CancellationTokenSource associé à CancellationToken dans l'objet parallelOptions a été supprimé.

Remarques

Cette méthode peut être utilisée pour exécuter un ensemble d’opérations, potentiellement en parallèle. Le jeton d’annulation transmis avec la ParallelOptions structure permet à l’appelant d’annuler toute l’opération. Pour plus d’informations, consultez Annulation dans les threads managés.

Pour plus d’informations, consultez Comment : utiliser parallel_invoke pour exécuter des opérations parallèles.

S’applique à

Share via

Parallel.Invoke Méthode

Définition

Surcharges

Invoke(Action[])

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Invoke(ParallelOptions, Action[])

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires