Parallel.Invoke Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Végrehajtja az egyes megadott műveleteket, esetleg párhuzamosan.
Túlterhelések
| Name | Description |
|---|---|
| Invoke(Action[]) |
Végrehajtja az egyes megadott műveleteket, esetleg párhuzamosan. |
| Invoke(ParallelOptions, Action[]) |
Végrehajtja az egyes megadott műveleteket, esetleg párhuzamosan, kivéve, ha a felhasználó megszakítja a műveletet. |
Invoke(Action[])
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
Végrehajtja az egyes megadott műveleteket, esetleg párhuzamosan.
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éterek
Kivételek
Az actions argumentum a következő null: .
Az a kivétel, amely akkor lesz kivetve, ha a actions tömb bármely művelete kivételt okoz.
A actions tömb tartalmaz egy null elemet.
Példák
Ez a példa bemutatja, hogyan használhatja a Invoke metódust más metódusokkal, névtelen delegáltakkal és lambdakifejezésekkel.
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
Megjegyzések
Ez a módszer több művelet végrehajtására is használható, akár párhuzamosan is.
Nincs garancia a műveletek végrehajtásának sorrendjére, illetve arra, hogy párhuzamosan hajtják-e végre őket. Ez a módszer mindaddig nem tér vissza, amíg az összes megadott művelet be nem fejeződik, függetlenül attól, hogy a teljesítés normál vagy kivételes leállás miatt következik be.
További információért lásd: Hogyan: A Parallel.Invoke használata párhuzamos műveletek végrehajtására.
A következőre érvényes:
Invoke(ParallelOptions, Action[])
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
- Forrás:
- Parallel.cs
Végrehajtja az egyes megadott műveleteket, esetleg párhuzamosan, kivéve, ha a felhasználó megszakítja a műveletet.
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éterek
- parallelOptions
- ParallelOptions
A művelet viselkedését konfiguráló objektum.
- actions
- Action[]
Végrehajtandó műveletek tömbje.
Kivételek
A CancellationToken be van parallelOptions állítva.
Az actions argumentum a következő null: .
-vagy-
Az parallelOptions argumentum a következő null: .
Az a kivétel, amely akkor lesz kivetve, ha a actions tömb bármely művelete kivételt okoz.
A actions tömb tartalmaz egy null elemet.
A CancellationTokenSource benne lévőhöz CancellationTokenparallelOptions társított el lett adva.
Megjegyzések
Ez a módszer több művelet végrehajtására is használható, akár párhuzamosan is. A struktúrával ParallelOptions átadott lemondási jogkivonat lehetővé teszi, hogy a hívó megszakítsa a teljes műveletet. További információ: Lemondás felügyelt szálakban.
Nincs garancia a műveletek végrehajtásának sorrendjére, illetve arra, hogy párhuzamosan hajtják-e végre őket. Ez a módszer mindaddig nem tér vissza, amíg az összes megadott művelet be nem fejeződik, függetlenül attól, hogy a teljesítés normál vagy kivételes leállás miatt következik be.
További információért lásd: Hogyan: A Parallel.Invoke használata párhuzamos műveletek végrehajtására.