共用方式為


TaskFactory.ContinueWhenAny 方法

定義

建立會在提供的任何一項工作完成時啟動的 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

例外狀況

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

tasks 陣列為 null

-或- continuationActionnull

continuationOptions 指定無效的 TaskContinuationOptions 值。

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

例外狀況

tasks 陣列為 null

-或- continuationActionnull

-或- schedulernull

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

continuationOptions 指定無效的 TaskContinuationOptions 值。

提供的 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

例外狀況

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

tasks 陣列為 null

-或- continuationAction 引數為 null

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

範例

下列範例示範如何使用 ContinueWhenAnyContinueWhenAll

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

例外狀況

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

-或- cancellationToken 已經處置。

tasks 陣列為 null

-或- continuationAction 引數為 null

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>

例外狀況

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

tasks 陣列為 null

-或- continuationFunctionnull

continuationOptions 指定無效的 TaskContinuationOptions 值。

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>

例外狀況

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

tasks 陣列為 null

-或- continuationFunctionnull

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>

例外狀況

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

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

tasks 陣列為 null

-或- continuationFunctionnull

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>

例外狀況

tasks 陣列為 null

-或- continuationFunctionnull

-或- schedulernull

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

continuationOptions 指定無效的 TaskContinuationOptions 值。

提供的 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

例外狀況

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

tasks 陣列為 null

-或- continuationActionnull

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

例外狀況

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

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

tasks 陣列為 null

-或- continuationActionnull

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

例外狀況

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

tasks 陣列為 null

-或- continuationActionnull

continuationOptions 指定無效的 TaskContinuationOptions 值。

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

例外狀況

tasks 陣列為 null

-或- continuationActionnull

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

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

continuationOptions 指定無效的 TaskContinuationOptions 值。

提供的 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>

例外狀況

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

tasks 陣列為 null

-或- continuationFunctionnull

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>

例外狀況

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

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

tasks 陣列為 null

-或- continuationFunctionnull

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>

例外狀況

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

tasks 陣列為 null

-或- continuationFunctionnull

continuationOptions 指定無效的 TaskContinuationOptions 值。

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)

類型參數

TResult

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

參數

tasks
Task[]

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

continuationFunction
Func<Task,TResult>

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

cancellationToken
CancellationToken

要指派給新接續工作的 CancellationToken

continuationOptions
TaskContinuationOptions

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

scheduler
TaskScheduler

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

傳回

Task<TResult>

新的接續 Task<TResult>

例外狀況

tasks 陣列為 null

-或- continuationFunctionnull

-或- schedulernull

tasks 陣列包含 null 值。

-或- tasks 陣列是空的。

continuationOptions 指定無效的 TaskContinuationOptions 值。

提供的 CancellationToken 已經過處置。

備註

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

另請參閱

適用於