Task.WaitAny メソッド

定義

名前空間:: System.Threading.Tasks

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

アセンブリ:: mscorlib.dll

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

アセンブリ:: netstandard.dll

重要

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

指定された Task オブジェクトのいずれかが実行を完了するまで待機します。

オーバーロード

名前	説明
WaitAny(Task[], Int32, CancellationToken)	指定した Task オブジェクトが指定したミリ秒以内に実行を完了するか、キャンセルトークンが取り消されるまで待機します。
WaitAny(Task[], TimeSpan)	指定した Task オブジェクトのいずれかが、指定した時間間隔内で実行を完了するまで待機します。
WaitAny(Task[], Int32)	指定した Task オブジェクトのいずれかが、指定したミリ秒以内に実行を完了するまで待機します。
WaitAny(Task[], CancellationToken)	待機が取り消されない限り、指定された Task オブジェクトのいずれかが実行を完了するまで待機します。
WaitAny(Task[])	指定された Task オブジェクトのいずれかが実行を完了するまで待機します。

WaitAny(Task[], Int32, CancellationToken)

指定した Task オブジェクトが指定したミリ秒以内に実行を完了するか、キャンセルトークンが取り消されるまで待機します。

public:
 static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

public static int WaitAny(System.Threading.Tasks.Task[] tasks, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

static member WaitAny : System.Threading.Tasks.Task[] * int * System.Threading.CancellationToken -> int

Public Shared Function WaitAny (tasks As Task(), millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Integer

パラメーター

tasks: Task[]

待機する Task インスタンスの配列。

millisecondsTimeout: Int32

待機するミリ秒数、または無期限に待機する Infinite (-1)。

cancellationToken: CancellationToken

タスクの完了を待機している間に観察する CancellationToken 。

返品

Int32

tasks配列引数の完了したタスクのインデックス。タイムアウトが発生した場合は -1。

例外

ObjectDisposedException

Taskが破棄されました。

ArgumentNullException

tasks引数はnull。

ArgumentOutOfRangeException

millisecondsTimeout は-1 以外の負の数で、無限タイムアウトを表します。

ArgumentException

tasks引数に null 要素が含まれています。

OperationCanceledException

cancellationToken は取り消されました。

適用対象

WaitAny(Task[], TimeSpan)

指定した Task オブジェクトのいずれかが、指定した時間間隔内で実行を完了するまで待機します。

public:
 static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, TimeSpan timeout);

public static int WaitAny(System.Threading.Tasks.Task[] tasks, TimeSpan timeout);

static member WaitAny : System.Threading.Tasks.Task[] * TimeSpan -> int

Public Shared Function WaitAny (tasks As Task(), timeout As TimeSpan) As Integer

パラメーター

tasks: Task[]

待機する Task インスタンスの配列。

timeout: TimeSpan

待機するミリ秒数を表す TimeSpan 、または無期限に待機する -1 ミリ秒を表す TimeSpan 。

返品

Int32

tasks配列引数の完了したタスクのインデックス。タイムアウトが発生した場合は -1。

例外

ObjectDisposedException

Taskが破棄されました。

ArgumentNullException

tasks引数はnull。

ArgumentOutOfRangeException

timeout引数のTotalMilliseconds プロパティは、-1 以外の負の数です。これは無限タイムアウトを表します。

-または-

timeout引数のTotalMilliseconds プロパティが Int32.MaxValue より大きい。

ArgumentException

tasks引数に null 要素が含まれています。

適用対象

WaitAny(Task[], Int32)

指定した Task オブジェクトのいずれかが、指定したミリ秒以内に実行を完了するまで待機します。

public:
 static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, int millisecondsTimeout);

public static int WaitAny(System.Threading.Tasks.Task[] tasks, int millisecondsTimeout);

static member WaitAny : System.Threading.Tasks.Task[] * int -> int

Public Shared Function WaitAny (tasks As Task(), millisecondsTimeout As Integer) As Integer

パラメーター

tasks: Task[]

待機する Task インスタンスの配列。

millisecondsTimeout: Int32

待機するミリ秒数、または無期限に待機する Infinite (-1)。

返品

Int32

tasks配列引数の完了したタスクのインデックス。タイムアウトが発生した場合は -1。

例外

ObjectDisposedException

Taskが破棄されました。

ArgumentNullException

tasks引数はnull。

ArgumentOutOfRangeException

millisecondsTimeout は-1 以外の負の数で、無限タイムアウトを表します。

ArgumentException

tasks引数に null 要素が含まれています。

適用対象

WaitAny(Task[], CancellationToken)

待機が取り消されない限り、指定された Task オブジェクトのいずれかが実行を完了するまで待機します。

public:
 static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, System::Threading::CancellationToken cancellationToken);

public static int WaitAny(System.Threading.Tasks.Task[] tasks, System.Threading.CancellationToken cancellationToken);

static member WaitAny : System.Threading.Tasks.Task[] * System.Threading.CancellationToken -> int

Public Shared Function WaitAny (tasks As Task(), cancellationToken As CancellationToken) As Integer

パラメーター

tasks: Task[]

待機する Task インスタンスの配列。

cancellationToken: CancellationToken

タスクの完了を待機している間に観察する CancellationToken 。

返品

Int32

tasks配列引数の完了したタスクのインデックス。

例外

ObjectDisposedException

Taskが破棄されました。

ArgumentNullException

tasks引数はnull。

ArgumentException

tasks引数に null 要素が含まれています。

OperationCanceledException

cancellationToken は取り消されました。

適用対象

WaitAny(Task[])

指定された Task オブジェクトのいずれかが実行を完了するまで待機します。

public:
 static int WaitAny(... cli::array <System::Threading::Tasks::Task ^> ^ tasks);

public static int WaitAny(params System.Threading.Tasks.Task[] tasks);

static member WaitAny : System.Threading.Tasks.Task[] -> int

Public Shared Function WaitAny (ParamArray tasks As Task()) As Integer

パラメーター

tasks: Task[]

待機する Task インスタンスの配列。

返品

Int32

tasks配列内の完了したTask オブジェクトのインデックス。

例外

ObjectDisposedException

Taskが破棄されました。

ArgumentNullException

tasks引数はnull。

ArgumentException

tasks引数に null 要素が含まれています。

例

次の例では、5 つのタスクを起動し、それぞれが 50 ミリ秒以上または最大 1,050 ミリ秒でスリープ状態になります。その後、 WaitAny メソッドは、タスクのいずれかが完了するまで待機します。この例では、待機を終了したタスクのタスク ID と、すべてのタスクの現在の状態を表示します。

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

public class Example
{
   public static void Main()
   {
      Task[] tasks = new Task[5];
      for (int ctr = 0; ctr <= 4; ctr++) {
         int factor = ctr;
         tasks[ctr] = Task.Run(() => Thread.Sleep(factor * 250 + 50));
      }
      int index = Task.WaitAny(tasks);
      Console.WriteLine("Wait ended because task #{0} completed.",
                        tasks[index].Id);
      Console.WriteLine("\nCurrent Status of Tasks:");
      foreach (var t in tasks)
         Console.WriteLine("   Task {0}: {1}", t.Id, t.Status);
   }
}
// The example displays output like the following:
//       Wait ended because task #1 completed.
//
//       Current Status of Tasks:
//          Task 1: RanToCompletion
//          Task 2: Running
//          Task 3: Running
//          Task 4: Running
//          Task 5: Running

open System.Threading
open System.Threading.Tasks

let tasks =
    [| for factor = 0 to 4 do
           Task.Run(fun () -> Thread.Sleep(factor * 250 + 50)) |]

let index = Task.WaitAny tasks
printfn $"Wait ended because task #{tasks[index].Id} completed."
printfn "\nCurrent Status of Tasks:"

for t in tasks do
    printfn $"   Task {t.Id}: {t.Status}"


// The example displays output like the following:
//       Wait ended because task #1 completed.
//
//       Current Status of Tasks:
//          Task 1: RanToCompletion
//          Task 2: Running
//          Task 3: Running
//          Task 4: Running
//          Task 5: Running

Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tasks(4) As Task
      For ctr As Integer = 0 To 4
         Dim factor As Integer = ctr
         tasks(ctr) = Task.Run(Sub() Thread.Sleep(factor * 250 + 50))
      Next
      Dim index As Integer = Task.WaitAny(tasks)

      Console.WriteLine("Wait ended because task #{0} completed.",
                        tasks(index).Id)
      Console.WriteLine()
      Console.WriteLine("Current Status of Tasks:")
      For Each t In tasks
         Console.WriteLine("   Task {0}: {1}", t.Id, t.Status)
      Next
   End Sub
End Module
' The example displays output like the following:
'       Wait ended because task #1 completed.
'
'       Current Status of Tasks:
'          Task 1: RanToCompletion
'          Task 2: Running
'          Task 3: Running
'          Task 4: Running
'          Task 5: Running

適用対象

フィードバック

このページはお役に立ちましたか?