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

定義

指定された一連のアクションの各アクションを実行します (場合によっては並列で)。Executes each of the provided actions, possibly in parallel.

オーバーロード

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

指定された一連のアクションの各アクションを実行します (場合によっては並列で)。Executes each of the provided actions, possibly in parallel.

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

操作がユーザーによって取り消されていない限り、指定された各アクションを実行します。アクションは並列で実行される可能性があります。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[])

指定された一連のアクションの各アクションを実行します (場合によっては並列で)。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())

パラメーター

actions
Action[]

実行対象の Action の配列。An array of Action to execute.

例外

actions 引数が null です。The actions argument is null.

actions 配列内のアクションが例外をスローしたときにスローされる例外。The exception that is thrown when any action in the actions array throws an exception.

actions 配列に null 要素が含まれています。The actions array contains a null element.

この例ではInvoke 、メソッドを他のメソッド、匿名デリゲート、およびラムダ式と共に使用する方法を示します。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

注釈

このメソッドは、一連の操作を並列で実行するために使用できます。This method can be used to execute a set of operations, potentially in parallel.

操作が実行される順序や、並列で実行するかどうかは保証されません。No guarantees are made about the order in which the operations execute or whether they execute in parallel. このメソッドは、指定された各操作が完了するまでは戻りません。通常または例外的な終了によって完了が発生したかどうかは関係ありません。This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

詳細については、「How to: Use Parallel.Invoke to Execute Parallel Operations」を参照してください。For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

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

操作がユーザーによって取り消されていない限り、指定された各アクションを実行します。アクションは並列で実行される可能性があります。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

パラメーター

parallelOptions
ParallelOptions ParallelOptions ParallelOptions ParallelOptions

この操作の動作を構成するオブジェクト。An object that configures the behavior of this operation.

actions
Action[]

実行対象のアクションの配列。An array of actions to execute.

例外

actions 引数が null です。The actions argument is null.

- または --or- parallelOptions 引数が null です。The parallelOptions argument is null.

actions 配列内のアクションが例外をスローしたときにスローされる例外。The exception that is thrown when any action in the actions array throws an exception.

actions 配列に null 要素が含まれています。The actions array contains a null element.

parallelOptions 内の CancellationTokenSource に関連付けられている CancellationToken は破棄されました。The CancellationTokenSource associated with the CancellationToken in the parallelOptions has been disposed.

注釈

このメソッドは、一連の操作を並列で実行するために使用できます。This method can be used to execute a set of operations, potentially in parallel. ParallelOptions構造体と共に渡されたキャンセルトークンを使用すると、呼び出し元は操作全体を取り消すことができます。The cancellation token passed in with the ParallelOptions structure enables the caller to cancel the entire operation. 詳細については、「マネージド スレッドのキャンセル」を参照してください。For more information, see Cancellation in Managed Threads.

操作が実行される順序や、並列で実行するかどうかは保証されません。No guarantees are made about the order in which the operations execute or whether they execute in parallel. このメソッドは、指定された各操作が完了するまでは戻りません。通常または例外的な終了によって完了が発生したかどうかは関係ありません。This method does not return until each of the provided operations has completed, regardless of whether completion occurs due to normal or exceptional termination.

詳細については、「How to: Use Parallel.Invoke to Execute Parallel Operations」を参照してください。For more information, see How to: Use Parallel.Invoke to Execute Parallel Operations.

適用対象