TaskFactory.ContinueWhenAny 方法

參考

定義

命名空間:: System.Threading.Tasks

組件:: System.Threading.Tasks.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

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

ContinueWhenAny(Task[], Action<Task>, TaskContinuationOptions)

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

public:
 System::Threading::Tasks::Task ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<System::Threading::Tasks::Task ^> ^ continuationAction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Action<System.Threading.Tasks.Task> continuationAction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task

Public Function ContinueWhenAny (tasks As Task(), continuationAction As Action(Of Task), continuationOptions As TaskContinuationOptions) As Task

參數

tasks: Task[]

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

continuationAction: Action<Task>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task 的行為。

傳回

Task

新的接續 Task。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 為 null。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

備註

NotOn * 和 OnlyOn * TaskContinuationOptions ，其限制 TaskStatus 將執行接續的狀態，與 ContinueWhenAny 不合法。

另請參閱

適用於

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

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

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

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

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWhenAny (tasks As Task(), continuationAction As Action(Of Task), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

參數

tasks: Task[]

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

continuationAction: Action<Task>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task 的行為。

scheduler: TaskScheduler

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

傳回

Task

新的接續 Task。

例外狀況

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 為 null。

-或- scheduler 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ObjectDisposedException

提供的 CancellationToken 已經過處置。

備註

NotOn 和 OnlyOn * * TaskContinuationOptions ，其限制 TaskStatus 會執行接續的狀態，使用 ContinueWhenAny 不合法。

另請參閱

適用於

ContinueWhenAny(Task[], Action<Task>)

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

public:
 System::Threading::Tasks::Task ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<System::Threading::Tasks::Task ^> ^ continuationAction);

public System.Threading.Tasks.Task ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Action<System.Threading.Tasks.Task> continuationAction);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task> -> System.Threading.Tasks.Task

Public Function ContinueWhenAny (tasks As Task(), continuationAction As Action(Of Task)) As Task

參數

tasks: Task[]

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

continuationAction: Action<Task>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

傳回

Task

新的接續 Task。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

範例

下列範例示範如何使用 ContinueWhenAny 和 ContinueWhenAll ：

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

class ContinueWhenMultiDemo
{
    // Demonstrated features:
    // 		Task.Factory
    //		TaskFactory.ContinueWhenAll()
    //		TaskFactory.ContinueWhenAny()
    //		Task.Wait()
    // Expected results:
    // 		Three tasks are created in parallel. 
    //		Each task for a different period of time prints a number and returns it.
    //      A ContinueWhenAny() task indicates the first of the three tasks to complete.
    //      A ContinueWhenAll() task sums up the results of the three tasks and prints out the total.
    // Documentation:
    //		http://msdn.microsoft.com/library/system.threading.tasks.taskfactory_members(VS.100).aspx
    static void Main()
    {
        // Schedule a list of tasks that return integer
        Task<int>[] tasks = new Task<int>[]
            {
                Task<int>.Factory.StartNew(() => 
                    {
                        Thread.Sleep(500);
                        Console.WriteLine("Task={0}, Thread={1}, x=5", Task.CurrentId, Thread.CurrentThread.ManagedThreadId);
                        return 5;
                    }),

                Task<int>.Factory.StartNew(() => 
                    {
                        Thread.Sleep(10);
                        Console.WriteLine("Task={0}, Thread={1}, x=3", Task.CurrentId, Thread.CurrentThread.ManagedThreadId);
                        return 3;
                    }),

                Task<int>.Factory.StartNew(() => 
                    {
                        Thread.Sleep(200);
                        Console.WriteLine("Task={0}, Thread={1}, x=2", Task.CurrentId, Thread.CurrentThread.ManagedThreadId);
                        return 2;
                    })
            };

        // Schedule a continuation to indicate the result of the first task to complete
        Task.Factory.ContinueWhenAny(tasks, winner =>
        {
            // You would expect winning result = 3 on multi-core systems, because you expect
            // tasks[1] to finish first.
            Console.WriteLine("Task={0}, Thread={1} (ContinueWhenAny): Winning result = {2}", Task.CurrentId, Thread.CurrentThread.ManagedThreadId, winner.Result);
        });

        // Schedule a continuation that sums up the results of all tasks, then wait on it.
        // The list of antecendent tasks is passed as an argument by the runtime.
        Task.Factory.ContinueWhenAll(tasks,
            (antecendents) =>
            {
                int sum = 0;
                foreach (Task<int> task in antecendents)
                {
                    sum += task.Result;
                }

                Console.WriteLine("Task={0}, Thread={1}, (ContinueWhenAll): Total={2} (expected 10)", Task.CurrentId, Thread.CurrentThread.ManagedThreadId, sum);
            })
            .Wait();
    }
}

Imports System.Threading
Imports System.Threading.Tasks

Module ContinuationWhenMulti
    ' Demonstrated features:
    '   Task.Factory
    '   TaskFactory.ContinueWhenAll()
    '   TaskFactory.ContinueWhenAny()
    '   Task.Wait()
    ' Expected results:
    '   Three tasks are created in parallel. 
    '   Each task for a different period of time prints a number and returns it.
    '   A ContinueWhenAny() task indicates the first of the three tasks to complete.
    '   A ContinueWhenAll() task sums up the results of the three tasks and prints out the total.
    ' Documentation:
    '   http://msdn.microsoft.com/library/system.threading.tasks.taskfactory_members(VS.100).aspx
    Sub Main()
        ' Schedule a list of tasks that return integer
        Dim tasks As Task(Of Integer)() = New Task(Of Integer)() {
            Task(Of Integer).Factory.StartNew(Function()
                                                  Thread.Sleep(500)
                                                  Console.WriteLine("Task={0}, Thread={1}, x=5", Task.CurrentId, Thread.CurrentThread.ManagedThreadId)
                                                  Return 5
                                              End Function),
            Task(Of Integer).Factory.StartNew(Function()
                                                  Thread.Sleep(10)
                                                  Console.WriteLine("Task={0}, Thread={1}, x=3", Task.CurrentId, Thread.CurrentThread.ManagedThreadId)
                                                  Return 3
                                              End Function),
            Task(Of Integer).Factory.StartNew(Function()
                                                  Thread.Sleep(200)
                                                  Console.WriteLine("Task={0}, Thread={1}, x=2", Task.CurrentId, Thread.CurrentThread.ManagedThreadId)
                                                  Return 2
                                              End Function)}


        ' Schedule a continuation to indicate the result of the first task to complete
        Task.Factory.ContinueWhenAny(tasks, Sub(winner)
                                                ' You would expect winning result = 3 on multi-core systems, because you expect
                                                ' tasks[1] to finish first.
                                                Console.WriteLine("Task={0}, Thread={1} (ContinueWhenAny): Winning result = {2}", Task.CurrentId, Thread.CurrentThread.ManagedThreadId, winner.Result)
                                            End Sub)


        ' Schedule a continuation that sums up the results of all tasks, then wait on it.
        ' The list of antecendent tasks is passed as an argument by the runtime.
        Task.Factory.ContinueWhenAll(tasks, Sub(antecendents)
                                                Dim sum As Integer = 0
                                                For Each task__1 As Task(Of Integer) In antecendents
                                                    sum += task__1.Result
                                                Next
                                                Console.WriteLine("Task={0}, Thread={1}, (ContinueWhenAll): Total={2} (expected 10)", Task.CurrentId, Thread.CurrentThread.ManagedThreadId, sum)
                                            End Sub).Wait()
    End Sub
End Module

另請參閱

適用於

ContinueWhenAny(Task[], Action<Task>, CancellationToken)

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

public:
 System::Threading::Tasks::Task ^ ContinueWhenAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<System::Threading::Tasks::Task ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task ContinueWhenAny (System.Threading.Tasks.Task[] tasks, Action<System.Threading.Tasks.Task> continuationAction, System.Threading.CancellationToken cancellationToken);

member this.ContinueWhenAny : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ContinueWhenAny (tasks As Task(), continuationAction As Action(Of Task), cancellationToken As CancellationToken) As Task

參數

tasks: Task[]

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

continuationAction: Action<Task>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

傳回

Task

新的接續 Task。

例外狀況

ObjectDisposedException

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

-或- cancellationToken 已經處置。

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 引數為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TAntecedentResult, typename TResult>
 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,TResult> (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, TResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult), continuationOptions As TaskContinuationOptions) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationFunction: Func<Task<TAntecedentResult>,TResult>

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

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task<TResult> 的行為。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

備註

NotOn * 和 OnlyOn * TaskContinuationOptions ，其限制 TaskStatus 將執行接續的狀態，與 ContinueWhenAny 不合法。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TAntecedentResult, typename TResult>
 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,TResult> (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, TResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult)) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationFunction: Func<Task<TAntecedentResult>,TResult>

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

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TAntecedentResult, typename TResult>
 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,TResult> (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, TResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult), TResult), cancellationToken As CancellationToken) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationFunction: Func<Task<TAntecedentResult>,TResult>

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

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

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

-或- 提供的 CancellationToken 已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TAntecedentResult, typename TResult>
 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,TResult> (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, TResult) (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 的結果類型。

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationFunction: Func<Task<TAntecedentResult>,TResult>

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

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task<TResult> 的行為。

scheduler: TaskScheduler

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

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

-或- scheduler 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ObjectDisposedException

提供的 CancellationToken 已經過處置。

備註

NotOn * 和 OnlyOn * TaskContinuationOptions ，其限制 TaskStatus 將執行接續的狀態，與 ContinueWhenAny 不合法。

另請參閱

適用於

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Action<Task<TAntecedentResult>>)

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

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

public System.Threading.Tasks.Task ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Action<System.Threading.Tasks.Task<TAntecedentResult>> continuationAction);

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

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult))) As Task

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationAction: Action<Task<TAntecedentResult>>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

傳回

Task

新的接續 Task。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Action<Task<TAntecedentResult>>, CancellationToken)

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

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

public System.Threading.Tasks.Task ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Action<System.Threading.Tasks.Task<TAntecedentResult>> continuationAction, System.Threading.CancellationToken cancellationToken);

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

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult)), cancellationToken As CancellationToken) As Task

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationAction: Action<Task<TAntecedentResult>>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

傳回

Task

新的接續 Task。

例外狀況

ObjectDisposedException

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

-或- 提供的 CancellationToken 已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Action<Task<TAntecedentResult>>, TaskContinuationOptions)

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

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

public System.Threading.Tasks.Task ContinueWhenAny<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Action<System.Threading.Tasks.Task<TAntecedentResult>> continuationAction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

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

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult)), continuationOptions As TaskContinuationOptions) As Task

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationAction: Action<Task<TAntecedentResult>>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task 的行為。

傳回

Task

新的接續 Task。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 為 null。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

備註

NotOn 和 OnlyOn * * TaskContinuationOptions ，其限制 TaskStatus 會執行接續的狀態，使用 ContinueWhenAny 不合法。

另請參閱

適用於

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

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

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

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

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

Public Function ContinueWhenAny(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult)), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

類型參數

TAntecedentResult

前項 tasks 的結果類型。

參數

tasks: Task<TAntecedentResult>[]

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

continuationAction: Action<Task<TAntecedentResult>>

當 tasks 陣列中的任一個工作已經完成時，要執行的動作委派。

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task 的行為。

scheduler: TaskScheduler

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

傳回

Task

新的接續 Task。

例外狀況

ArgumentNullException

tasks 陣列為 null。

-或- continuationAction 為 null。

-或- paramref name="scheduler" /> 是 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ObjectDisposedException

提供的 CancellationToken 已經過處置。

備註

NotOn 和 OnlyOn * * TaskContinuationOptions ，其限制 TaskStatus 會執行接續的狀態，使用 ContinueWhenAny 不合法。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TResult>
 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<TResult> (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(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task, TResult)) As Task(Of TResult)

類型參數

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task[]

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

continuationFunction: Func<Task,TResult>

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

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TResult>
 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<TResult> (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(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task, TResult), cancellationToken As CancellationToken) As Task(Of TResult)

類型參數

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task[]

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

continuationFunction: Func<Task,TResult>

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

cancellationToken: CancellationToken

要指派給新接續工作的 CancellationToken。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

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

-或- 提供的 CancellationToken 已經過處置。

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TResult>
 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<TResult> (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(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task, TResult), continuationOptions As TaskContinuationOptions) As Task(Of TResult)

類型參數

TResult

由 continuationFunction 委派傳回，且與建立之 Task<TResult> 相關聯的結果的類型。

參數

tasks: Task[]

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

continuationFunction: Func<Task,TResult>

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

continuationOptions: TaskContinuationOptions

TaskContinuationOptions 值，控制建立之接續 Task<TResult> 的行為。

傳回

Task<TResult>

新的接續 Task<TResult>。

例外狀況

ObjectDisposedException

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

ArgumentNullException

tasks 陣列為 null。

-或- continuationFunction 為 null。

ArgumentOutOfRangeException

continuationOptions 指定無效的 TaskContinuationOptions 值。

ArgumentException

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

備註

NotOn * 和 OnlyOn * TaskContinuationOptions ，其限制 TaskStatus 將執行接續的狀態，與 ContinueWhenAny 不合法。

另請參閱

適用於

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

建立會在提供的任何一項工作完成時啟動的 Task<TResult>。

public:
generic <typename TResult>
 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<TResult> (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(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task, TResult), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TResult)