Task.WaitAny 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

等候任一提供的 Task 物件完成執行。

多載

WaitAny(Task[], TimeSpan)	等候其中任何一個提供的 Task 物件在指定的時間間隔內完成執行。
WaitAny(Task[], Int32, CancellationToken)	等待所有提供的 Task 物件在指定的毫秒數內完成執行。
WaitAny(Task[], Int32)	等候所有提供的 Task 物件在指定的毫秒數內完成執行。
WaitAny(Task[], CancellationToken)	等候所有提供的 Task 物件完成執行。
WaitAny(Task[])	等候任一提供的 Task 物件完成執行。

WaitAny(Task[], TimeSpan)

來源:

Task.cs

等候其中任何一個提供的 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，代表等候毫秒數；或是 TimeSpan，代表無限期等候的 -1 毫秒。

傳回

Int32

tasks 陣列引數中已完成工作的索引；如果發生逾時，則為 -1。

例外狀況

ObjectDisposedException

Task 已經處置。

ArgumentNullException

tasks 引數為 null。

ArgumentOutOfRangeException

timeout 的 TotalMilliseconds 屬性是不等於 -1 的負數，-1 代表等候逾時為無限。

-或-

自 TotalMilliseconds 變數的 timeout 屬性大於 Int32.MaxValue。

ArgumentException

tasks 引數包含 null 項目。

WaitAny(Task[], Int32, CancellationToken)

來源:

Task.cs

等待所有提供的 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[], Int32)

來源:

Task.cs

等候所有提供的 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.cs

等候所有提供的 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.cs

等候任一提供的 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 項目。

範例

下列範例會啟動五個工作，每個工作至少睡眠 50 毫秒，或最多 1,050 毫秒。 然後，方法 WaitAny 會等候任何工作完成。 此範例會顯示結束等候之工作的工作標識碼，以及所有工作的目前狀態。

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