Parallel.Invoke Méthode
Définition
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
| Nom | Description |
|---|---|
| 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
Exceptions
L’argument actions est null.
Exception levée lorsqu’une action dans le actions tableau lève une exception.
Le actions tableau contient un null élément.
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, que l’achèvement se produise en raison d’un arrêt normal ou exceptionnel.
Pour plus d’informations, consultez Guide pratique pour 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
Dans CancellationToken le parallelOptions jeu.
Exception levée lorsqu’une action dans le actions tableau lève une exception.
Le actions tableau contient un null élément.
Associé CancellationTokenSource à l’élément CancellationToken dans le fichier 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 l’opération entière. Pour plus d’informations, consultez Annulation dans les threads managés.
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, que l’achèvement se produise en raison d’un arrêt normal ou exceptionnel.
Pour plus d’informations, consultez Guide pratique pour utiliser Parallel.Invoke pour exécuter des opérations parallèles.