Task.RunSynchronously メソッド

リファレンス

定義

名前空間:: System.Threading.Tasks

アセンブリ:: System.Threading.Tasks.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の Task で TaskScheduler を同期的に実行します。

オーバーロード

RunSynchronously(TaskScheduler)	指定された Task で TaskScheduler を同期的に実行します。
RunSynchronously()	現在の Task で TaskScheduler を同期的に実行します。

RunSynchronously(TaskScheduler)

Source:: Task.cs

Source:: Task.cs

Source:: Task.cs

指定された Task で TaskScheduler を同期的に実行します。

public:
 void RunSynchronously(System::Threading::Tasks::TaskScheduler ^ scheduler);

public void RunSynchronously (System.Threading.Tasks.TaskScheduler scheduler);

member this.RunSynchronously : System.Threading.Tasks.TaskScheduler -> unit

Public Sub RunSynchronously (scheduler As TaskScheduler)

パラメーター

scheduler: TaskScheduler

このタスクインラインの実行を試みるスケジューラ。

例外

ObjectDisposedException

Task インスタンスは破棄されています。

ArgumentNullException

scheduler 引数が null です。

InvalidOperationException

Task は、開始する有効な状態にはありません。既に開始、実行、またはキャンセルされたか、ダイレクトスケジューリングをサポートしない方法で作成された可能性があります。

注釈

メソッドを呼び出RunSynchronouslyして実行されるタスクは、または Task<TResult> クラスコンストラクターをTask呼び出すことによってインスタンス化されます。同期的に実行されるタスクは、状態である Created 必要があります。タスクは 1 回だけ開始して実行できます。 2 回目にタスクをスケジュールしようとすると、例外が発生します。

ターゲットスケジューラで現在のスレッドでのこのタスクの実行がサポートされていない場合、タスクはスケジューラで実行されるようにスケジュールされ、タスクの実行が完了するまで現在のスレッドはブロックされます。このため、呼び出し元のスレッドは、などの Wait メソッドを呼び出して、タスクの実行が完了したことを確認する必要はありません。タスク操作の例外処理の詳細については、「例外処理」を参照してください。

こちらもご覧ください

適用対象

RunSynchronously()

Source:: Task.cs

Source:: Task.cs

Source:: Task.cs

現在の Task で TaskScheduler を同期的に実行します。

public:
 void RunSynchronously();

public void RunSynchronously ();

member this.RunSynchronously : unit -> unit

Public Sub RunSynchronously ()

例外

ObjectDisposedException

Task インスタンスは破棄されています。

InvalidOperationException

例

次の例では、メソッドを呼び出 RunSynchronously して実行されるタスクと、非同期に実行されたタスクを比較します。どちらの場合も、タスクは、タスクが実行されているスレッドのタスク ID と ID を表示する同じラムダ式を実行します。タスクは、1 から 1,000,000 までの整数の合計を計算します。この例の出力に示すように、メソッドを呼び出 RunSynchronously して実行されるタスクはアプリケーションスレッドで実行されますが、非同期タスクは実行されません。

using System;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("Application executing on thread {0}",
                        Thread.CurrentThread.ManagedThreadId);
      var asyncTask = Task.Run( () => {  Console.WriteLine("Task {0} (asyncTask) executing on Thread {1}",
                                                           Task.CurrentId,
                                                           Thread.CurrentThread.ManagedThreadId);
                                         long sum = 0;
                                         for (int ctr = 1; ctr <= 1000000; ctr++ )
                                            sum += ctr;
                                         return sum;
                                      });
      var syncTask = new Task<long>( () =>  { Console.WriteLine("Task {0} (syncTask) executing on Thread {1}",
                                                                 Task.CurrentId,
                                                                 Thread.CurrentThread.ManagedThreadId);
                                              long sum = 0;
                                              for (int ctr = 1; ctr <= 1000000; ctr++ )
                                                 sum += ctr;
                                              return sum;
                                            });
      syncTask.RunSynchronously();
      Console.WriteLine();
      Console.WriteLine("Task {0} returned {1:N0}", syncTask.Id, syncTask.Result);
      Console.WriteLine("Task {0} returned {1:N0}", asyncTask.Id, asyncTask.Result);
   }
}
// The example displays the following output:
//       Application executing on thread 1
//       Task 1 (syncTask) executing on Thread 1
//       Task 2 (asyncTask) executing on Thread 3
//       1 status: RanToCompletion
//       2 status: RanToCompletion
//
//       Task 2 returned 500,000,500,000
//       Task 1 returned 500,000,500,000

open System
open System.Threading
open System.Threading.Tasks

printfn $"Application executing on thread {Thread.CurrentThread.ManagedThreadId}"

let asyncTask =
    Task.Run(fun () ->
        printfn $"Task {Task.CurrentId} (asyncTask) executing on Thread {Thread.CurrentThread.ManagedThreadId}"
        let mutable sum = 0L

        for i = 1 to 1000000 do
            sum <- sum + int64 i

        sum)

let syncTask =
    new Task<int64>(fun () ->
        printfn $"Task {Task.CurrentId} (syncTask) executing on Thread {Thread.CurrentThread.ManagedThreadId}"
        let mutable sum = 0L

        for i = 1 to 1000000 do
            sum <- sum + int64 i

        sum)

syncTask.RunSynchronously()
printfn $"\nTask {syncTask.Id} returned {syncTask.Result:N0}"
printfn $"Task {asyncTask.Id} returned {asyncTask.Result:N0}"

// The example displays the following output:
//       Application executing on thread 1
//       Task 1 (syncTask) executing on Thread 1
//       Task 2 (asyncTask) executing on Thread 3
//       1 status: RanToCompletion
//       2 status: RanToCompletion
//
//       Task 2 returned 500,000,500,000
//       Task 1 returned 500,000,500,000

Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Console.WriteLine("Application executing on thread {0}",
                        Thread.CurrentThread.ManagedThreadId)
      Dim asyncTask = Task.Run( Function()
                                   Console.WriteLine("Task {0} (asyncTask) executing on Thread {1}",
                                                     Task.CurrentId,
                                                     Thread.CurrentThread.ManagedThreadId)
                                   Dim sum As Long = 0
                                   For ctr As Integer = 1 To 1000000
                                      sum += ctr
                                   Next
                                   Return sum
                                End Function)
      Dim syncTask As New Task(Of Long)( Function()
                                            Console.WriteLine("Task {0} (syncTask) executing on Thread {1}",
                                                              Task.CurrentId,
                                                              Thread.CurrentThread.ManagedThreadId)
                                            Dim sum As Long = 0
                                            For ctr As Integer = 1 To 1000000
                                               sum += ctr
                                            Next
                                            Return sum
                                         End Function)
      syncTask.RunSynchronously()
      Console.WriteLine()
      Console.WriteLine("Task {0} returned {1:N0}", syncTask.Id, syncTask.Result)
      Console.WriteLine("Task {0} returned {1:N0}", asyncTask.Id, asyncTask.Result)
   End Sub
End Module
' The example displays the following output:
'       Application executing on thread 1
'       Task 1 (syncTask) executing on Thread 1
'       Task 2 (asyncTask) executing on Thread 3
'       1 status: RanToCompletion
'       2 status: RanToCompletion
'
'       Task 2 returned 500,000,500,000
'       Task 1 returned 500,000,500,000

注釈

通常、タスクはスレッドプールスレッドで非同期的に実行され、呼び出し元のスレッドはブロックされません。メソッドを呼び出 RunSynchronously() して実行されるタスクは、現在 TaskScheduler のに関連付けられて、呼び出し元のスレッドで実行されます。ターゲットスケジューラが呼び出し元スレッドでこのタスクの実行をサポートしていない場合、タスクはスケジューラで実行されるようにスケジュールされ、呼び出し元のスレッドはタスクの実行が完了するまでブロックされます。タスクは同期的に実行されますが、呼び出し元のスレッドはを呼び出 Wait して、タスクがスローする可能性のある例外を処理する必要があります。例外処理の詳細については、「例外処理」を参照してください。

こちらもご覧ください

例外処理 (タスク並列ライブラリ)

適用対象

Task.RunSynchronously メソッド

定義

オーバーロード

RunSynchronously(TaskScheduler)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

RunSynchronously()

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース