Task.WhenAny 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

建立當任何提供的工作完成時，將會完成的工作。

多載

WhenAny(Task, Task)	建立當其中一個提供的工作完成時，將會完成的工作。
WhenAny(Task[])	建立當任何提供的工作完成時，將會完成的工作。
WhenAny(IEnumerable<Task>)	建立當任何提供的工作完成時，將會完成的工作。
WhenAny<TResult>(IEnumerable<Task<TResult>>)	建立當任何提供的工作完成時，將會完成的工作。
WhenAny<TResult>(Task<TResult>[])	建立當任何提供的工作完成時，將會完成的工作。
WhenAny<TResult>(Task<TResult>, Task<TResult>)	建立當其中一個提供的工作完成時，將會完成的工作。

WhenAny(Task, Task)

來源:

Task.cs

建立當其中一個提供的工作完成時，將會完成的工作。

public:
 static System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ WhenAny(System::Threading::Tasks::Task ^ task1, System::Threading::Tasks::Task ^ task2);

public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (System.Threading.Tasks.Task task1, System.Threading.Tasks.Task task2);

static member WhenAny : System.Threading.Tasks.Task * System.Threading.Tasks.Task -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>

Public Shared Function WhenAny (task1 As Task, task2 As Task) As Task(Of Task)

參數

task1

Task

要等候完成的第一個工作。

task2

Task

要等候完成的第二個工作。

傳回

Task<Task>

表示其中一個所提供工作完成的新工作。 其 Result 是先完成的工作。

例外狀況

ArgumentNullException

task1 或 task2null。

備註

傳回的工作會在任何提供的工作完成時完成。 傳回的工作一律會以 RanToCompletion 狀態結束，其 Result 設定為要完成的第一個工作。 即使第一個完成的工作是以 Canceled 或 Faulted 狀態結束，結果值還是 true。

WhenAny(Task[])

來源:

Task.cs

建立當任何提供的工作完成時，將會完成的工作。

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

public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (params System.Threading.Tasks.Task[] tasks);

static member WhenAny : System.Threading.Tasks.Task[] -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>

Public Shared Function WhenAny (ParamArray tasks As Task()) As Task(Of Task)

參數

tasks

Task[]

要等候完成的工作。

傳回

Task<Task>

表示其中一個所提供工作完成的工作。 傳回工作的 Result 是已完成的工作。

例外狀況

ArgumentNullException

tasks 自變數為 null。

ArgumentException

tasks 陣列包含 Null 工作或空白。

備註

傳回的工作會在任何提供的工作完成時完成。 傳回的工作一律會以 RanToCompletion 狀態結束，其 Result 設定為要完成的第一個工作。 即使第一個完成的工作是以 Canceled 或 Faulted 狀態結束，也是如此。

WhenAny(IEnumerable<Task>)

來源:

Task.cs

建立當任何提供的工作完成時，將會完成的工作。

public:
 static System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ WhenAny(System::Collections::Generic::IEnumerable<System::Threading::Tasks::Task ^> ^ tasks);

public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task> tasks);

static member WhenAny : seq<System.Threading.Tasks.Task> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>

Public Shared Function WhenAny (tasks As IEnumerable(Of Task)) As Task(Of Task)

參數

tasks

IEnumerable<Task>

要等候完成的工作。

傳回

Task<Task>

表示其中一個所提供工作完成的工作。 傳回工作的 Result 是已完成的工作。

例外狀況

ArgumentNullException

tasks 自變數 null。

ArgumentException

tasks 陣列包含 Null 工作或空白。

備註

傳回的工作會在任何提供的工作完成時完成。 傳回的工作一律會以 RanToCompletion 狀態結束，其 Result set 設為要完成的第一個工作。 即使第一個完成的工作是以 Canceled 或 Faulted 狀態結束，也是如此。

WhenAny<TResult>(IEnumerable<Task<TResult>>)

來源:

Task.cs

建立當任何提供的工作完成時，將會完成的工作。

public:
generic <typename TResult>
 static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(System::Collections::Generic::IEnumerable<System::Threading::Tasks::Task<TResult> ^> ^ tasks);

public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task<TResult>> tasks);

static member WhenAny : seq<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>

Public Shared Function WhenAny(Of TResult) (tasks As IEnumerable(Of Task(Of TResult))) As Task(Of Task(Of TResult))

類型參數

TResult

已完成工作的型別。

參數

tasks

IEnumerable<Task<TResult>>

要等候完成的工作。

傳回

Task<Task<TResult>>

表示其中一個所提供工作完成的工作。 傳回工作的 Result 是已完成的工作。

例外狀況

ArgumentNullException

tasks 自變數 null。

ArgumentException

tasks 陣列包含 Null 工作或空白。

備註

傳回的工作會在任何提供的工作完成時完成。 傳回的工作一律會以 RanToCompletion 狀態結束，其 Result 設定為要完成的第一個工作。 即使第一個完成的工作是以 Canceled 或 Faulted 狀態結束，也是如此。

WhenAny<TResult>(Task<TResult>[])

來源:

Task.cs

建立當任何提供的工作完成時，將會完成的工作。

public:
generic <typename TResult>
 static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(... cli::array <System::Threading::Tasks::Task<TResult> ^> ^ tasks);

public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (params System.Threading.Tasks.Task<TResult>[] tasks);

static member WhenAny : System.Threading.Tasks.Task<'Result>[] -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>

Public Shared Function WhenAny(Of TResult) (ParamArray tasks As Task(Of TResult)()) As Task(Of Task(Of TResult))

類型參數

TResult

已完成工作的型別。

參數

tasks

Task<TResult>[]

要等候完成的工作。

傳回

Task<Task<TResult>>

表示其中一個所提供工作完成的工作。 傳回工作的 Result 是已完成的工作。

例外狀況

ArgumentNullException

tasks 自變數為 null。

ArgumentException

tasks 陣列包含 Null 工作或空白。

備註

傳回的工作會在任何提供的工作完成時完成。 傳回的工作一律會以 RanToCompletion 狀態結束，其 Result 設定為要完成的第一個工作。 即使第一個完成的工作是以 Canceled 或 Faulted 狀態結束，也是如此。

WhenAny<TResult>(Task<TResult>, Task<TResult>)

來源:

Task.cs

建立當其中一個提供的工作完成時，將會完成的工作。

public:
generic <typename TResult>
 static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(System::Threading::Tasks::Task<TResult> ^ task1, System::Threading::Tasks::Task<TResult> ^ task2);

public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (System.Threading.Tasks.Task<TResult> task1, System.Threading.Tasks.Task<TResult> task2);

static member WhenAny : System.Threading.Tasks.Task<'Result> * System.Threading.Tasks.Task<'Result> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>

Public Shared Function WhenAny(Of TResult) (task1 As Task(Of TResult), task2 As Task(Of TResult)) As Task(Of Task(Of TResult))

類型參數

TResult

傳回之工作結果的類型。

參數

task1

Task<TResult>

要等候完成的第一個工作。

task2

Task<TResult>

要等候完成的第二個工作。

傳回

Task<Task<TResult>>

表示其中一個所提供工作完成的工作。 傳回的工作 TResult 是先完成的工作。

例外狀況

ArgumentNullException

task1 或 task2null。

備註

傳回的工作會在任何提供的工作完成時完成。 傳回的工作一律會以 RanToCompletion 狀態結束，其 Result 設定為要完成的第一個工作。 即使第一個完成的工作是以 Canceled 或 Faulted 狀態結束，結果值還是 true。

提示

在此方法傳回第一個完成的工作時，在Task.WhenAny（） 的每個多載版本中，其他工作會繼續執行，直到完成為止，即使是任何工作都已完成 Canceled 或 Faulted 狀態。 因此，如果不需要該行為，您可能想要在第一個工作完成之後取消所有剩餘的工作。