TaskFactory<TResult>.ContinueWhenAny 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

建立會在提供的任何一項工作完成時啟動的接續工作。

多載

ContinueWhenAny(Task[], Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny(Task[], Func<Task,TResult>)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny(Task[], Func<Task,TResult>, CancellationToken)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny(Task[], Func<Task,TResult>, TaskContinuationOptions)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, TaskContinuationOptions)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>)	建立會在提供的任何一項工作完成時啟動的接續工作。
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, CancellationToken)	建立會在提供的任何一項工作完成時啟動的接續工作。

ContinueWhenAny(Task[], Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<System::Threading::Tasks::Task ^, TResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task,TResult> continuationFunction, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task, 'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny (tasks As Task(), continuationFunction As Func(Of Task, TResult), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TResult)

參數

tasks

Task[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

cancellationToken

CancellationToken

要指派給新接續工作的取消語彙基元。

continuationOptions

TaskContinuationOptions

其中一個列舉值，這些值會控制已建立之接續工作的行為。 NotOn* 和 OnlyOn* 值無效。

scheduler

TaskScheduler

用來排定所建立之接續工作的工作排程器。

傳回

Task<TResult>

新的接續工作。

例外狀況

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

-或-

scheduler 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

ArgumentOutOfRangeException

continuationOptions 引數指定了無效的 TaskContinuationOptions 值。

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

-或-

已處置建立 cancellationToken 的 CancellationTokenSource。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• TaskScheduler
• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny(Task[], Func<Task,TResult>)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<System::Threading::Tasks::Task ^, TResult> ^ continuationFunction);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task,TResult> continuationFunction);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task, 'Result> -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny (tasks As Task(), continuationFunction As Func(Of Task, TResult)) As Task(Of TResult)

參數

tasks

Task[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

傳回

Task<TResult>

新的接續工作。

例外狀況

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

ArgumentException

tasks 陣列包含 null 值或為空白。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny(Task[], Func<Task,TResult>, CancellationToken)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<System::Threading::Tasks::Task ^, TResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task,TResult> continuationFunction, System.Threading.CancellationToken cancellationToken);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task, 'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny (tasks As Task(), continuationFunction As Func(Of Task, TResult), cancellationToken As CancellationToken) As Task(Of TResult)

參數

tasks

Task[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

cancellationToken

CancellationToken

要指派給新接續工作的取消語彙基元。

傳回

Task<TResult>

新的接續工作。

例外狀況

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

-或-

已處置建立 cancellationToken 的 CancellationTokenSource。

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny(Task[], Func<Task,TResult>, TaskContinuationOptions)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<System::Threading::Tasks::Task ^, TResult> ^ continuationFunction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task,TResult> continuationFunction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task, 'Result> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny (tasks As Task(), continuationFunction As Func(Of Task, TResult), continuationOptions As TaskContinuationOptions) As Task(Of TResult)

參數

tasks

Task[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

continuationOptions

TaskContinuationOptions

其中一個列舉值，這些值會控制已建立之接續工作的行為。 NotOn* 和 OnlyOn* 值無效。

傳回

Task<TResult>

新的接續工作。

例外狀況

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

ArgumentOutOfRangeException

continuationOptions 引數指定了無效的列舉值。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<System::Threading::Tasks::Task<TAntecedentResult> ^, TResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>,TResult> continuationFunction, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.ContinueWhenAny : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>, 'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks

Task<TAntecedentResult>[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task<TAntecedentResult>,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

cancellationToken

CancellationToken

要指派給新接續工作的取消語彙基元。

continuationOptions

TaskContinuationOptions

其中一個列舉值，這些值會控制已建立之接續工作的行為。 NotOn* 和 OnlyOn* 值無效。

scheduler

TaskScheduler

TaskScheduler，用來排定建立的接續 Task<TResult>。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

-或-

scheduler 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

ArgumentOutOfRangeException

continuationOptions 引數指定了無效的 TaskContinuationOptions 值。

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

-或-

已處置建立 cancellationToken 的 CancellationTokenSource。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, TaskContinuationOptions)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<System::Threading::Tasks::Task<TAntecedentResult> ^, TResult> ^ continuationFunction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>,TResult> continuationFunction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

member this.ContinueWhenAny : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>, 'Result> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult), continuationOptions As TaskContinuationOptions) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks

Task<TAntecedentResult>[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task<TAntecedentResult>,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

continuationOptions

TaskContinuationOptions

其中一個列舉值，這些值會控制已建立之接續工作的行為。 NotOn* 和 OnlyOn* 值無效。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

ArgumentOutOfRangeException

continuationOptions 引數指定了無效的列舉值。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<System::Threading::Tasks::Task<TAntecedentResult> ^, TResult> ^ continuationFunction);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>,TResult> continuationFunction);

member this.ContinueWhenAny : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>, 'Result> -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult)) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks

Task<TAntecedentResult>[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task<TAntecedentResult>,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, CancellationToken)

Source:

FutureFactory.cs

建立會在提供的任何一項工作完成時啟動的接續工作。

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<System::Threading::Tasks::Task<TAntecedentResult> ^, TResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>,TResult> continuationFunction, System.Threading.CancellationToken cancellationToken);

member this.ContinueWhenAny : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>, 'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult), cancellationToken As CancellationToken) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks

Task<TAntecedentResult>[]

工作的陣列，當其中一個工作完成時，會接續另一個工作。

continuationFunction

Func<Task<TAntecedentResult>,TResult>

當 tasks 陣列中的任一個工作已經完成時，要以非同步方式執行的函式委派。

cancellationToken

CancellationToken

要指派給新接續工作的取消語彙基元。

傳回

Task<TResult>

新的接續工作。

例外狀況

ObjectDisposedException

tasks陣列中的其中一個項目已經過處置。

-或-

已處置建立 cancellationToken 的 CancellationTokenSource。

ArgumentNullException

tasks 陣列為 null。

-或-

continuationFunction 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或-

tasks 陣列是空的。

備註

完成之後，工作會處於下列其中一種狀態： RanToCompletion 、 Faulted 或 Canceled 狀態。

另請參閱

• 工作平行程式庫 (TPL)
• 使用接續工作鏈結工作
• 工作取消