TaskFactory.ContinueWhenAll 方法

定義

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

多載

ContinueWhenAll(Task[], Action<Task[]>)

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

ContinueWhenAll(Task[], Action<Task[]>)

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task ^> ^> ^ continuationAction);
public System.Threading.Tasks.Task ContinueWhenAll (System.Threading.Tasks.Task[] tasks, Action<System.Threading.Tasks.Task[]> continuationAction);
member this.ContinueWhenAll : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task[]> -> System.Threading.Tasks.Task
Public Function ContinueWhenAll (tasks As Task(), continuationAction As Action(Of Task())) As Task

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

範例

下列範例會啟動個別的工作,使用正則運算式來計算一組文字檔中的單字數目。The following example launches separate tasks that use a regular expression to count the number of words in a set of text files. 當所有的 antecedent 工作完成時,會使用 ContinueWhenAll 方法來啟動顯示字數統計總計的工作。The ContinueWhenAll method is used to launch a task that displays the total word count when all the antecedent tasks have completed.

using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using System.Threading.Tasks;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string[] filenames = { "chapter1.txt", "chapter2.txt", 
                             "chapter3.txt", "chapter4.txt",
                             "chapter5.txt" };
      string pattern = @"\b\w+\b";
      var tasks = new List<Task>();  
      int totalWords = 0;
        
      // Determine the number of words in each file.
      foreach (var filename in filenames) 
         tasks.Add( Task.Factory.StartNew( fn => { if (! File.Exists(fn.ToString()))
                                                      throw new FileNotFoundException("{0} does not exist.", filename);

                                                   StreamReader sr = new StreamReader(fn.ToString());
                                                   String content = sr.ReadToEnd();
                                                   sr.Close();
                                                   int words = Regex.Matches(content, pattern).Count;
                                                   Interlocked.Add(ref totalWords, words); 
                                                   Console.WriteLine("{0,-25} {1,6:N0} words", fn, words); }, 
                                           filename));

      var finalTask = Task.Factory.ContinueWhenAll(tasks.ToArray(), wordCountTasks => {
                                                    int nSuccessfulTasks = 0;
                                                    int nFailed = 0;
                                                    int nFileNotFound = 0;
                                                    foreach (var t in wordCountTasks) {
                                                       if (t.Status == TaskStatus.RanToCompletion) 
                                                          nSuccessfulTasks++;
                                                       
                                                       if (t.Status == TaskStatus.Faulted) {
                                                          nFailed++;  
                                                          t.Exception.Handle( (e) => { 
                                                             if (e is FileNotFoundException)
                                                                nFileNotFound++;
                                                             return true;   
                                                          });
                                                       } 
                                                    }   
                                                    Console.WriteLine("\n{0,-25} {1,6} total words\n", 
                                                                      String.Format("{0} files", nSuccessfulTasks), 
                                                                      totalWords); 
                                                    if (nFailed > 0) {
                                                       Console.WriteLine("{0} tasks failed for the following reasons:", nFailed);
                                                       Console.WriteLine("   File not found:    {0}", nFileNotFound);
                                                       if (nFailed != nFileNotFound)
                                                          Console.WriteLine("   Other:          {0}", nFailed - nFileNotFound);
                                                    } 
                                                    });  
      finalTask.Wait();                                                                  
   }
}
// The example displays output like the following:
//       chapter2.txt               1,585 words
//       chapter1.txt               4,012 words
//       chapter5.txt               4,660 words
//       chapter3.txt               7,481 words
//       
//       4 files                    17738 total words
//       
//       1 tasks failed for the following reasons:
//          File not found:    1
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading
Imports System.Threading.Tasks
Imports System.Text.RegularExpressions

Module Example
   Dim totalWords As Integer = 0
   
   Public Sub Main()
      Dim filenames() As String = { "chapter1.txt", "chapter2.txt", 
                                    "chapter3.txt", "chapter4.txt",
                                    "chapter5.txt" }
      Dim pattern As String = "\b\w+\b"
      Dim tasks As New List(Of Task)()  
        
      ' Determine the number of words in each file.
      For Each filename In filenames 
         tasks.Add(Task.Factory.StartNew( Sub(fn)
                                             If Not File.Exists(filename)
                                                Throw New FileNotFoundException("{0} does not exist.", filename)
                                             End If
                                             
                                             Dim sr As New StreamReader(fn.ToString())
                                             Dim content As String = sr.ReadToEnd()
                                             sr.Close()
                                             Dim words As Integer = Regex.Matches(content, pattern).Count
                                             Interlocked.Add(totalWords, words) 
                                             Console.WriteLine("{0,-25} {1,6:N0} words", fn, words)
                                          End Sub, filename))
      Next
      
      Dim finalTask As Task = Task.Factory.ContinueWhenAll(tasks.ToArray(), 
                                                           Sub(wordCountTasks As Task() )
                                                              Dim nSuccessfulTasks As Integer = 0
                                                              Dim nFailed As Integer = 0
                                                              Dim nFileNotFound As Integer = 0
                                                              For Each t In wordCountTasks
                                                                 If t.Status = TaskStatus.RanToCompletion Then _ 
                                                                    nSuccessfulTasks += 1
                                                       
                                                                 If t.Status = TaskStatus.Faulted Then
                                                                    nFailed += 1  
                                                                    t.Exception.Handle(Function(e As Exception) 
                                                                                          If TypeOf e Is FileNotFoundException Then
                                                                                             nFileNotFound += 1
                                                                                          End If   
                                                                                          Return True   
                                                                                       End Function)                       
                                                                 End If 
                                                              Next   
                                                              Console.WriteLine()
                                                              Console.WriteLine("{0,-25} {1,6} total words", 
                                                                                String.Format("{0} files", nSuccessfulTasks), 
                                                                                totalWords) 
                                                              If nFailed > 0 Then
                                                                 Console.WriteLine()
                                                                 Console.WriteLine("{0} tasks failed for the following reasons:", nFailed)
                                                                 Console.WriteLine("   File not found:    {0}", nFileNotFound)
                                                                 If nFailed <> nFileNotFound Then
                                                                    Console.WriteLine("   Other:          {0}", nFailed - nFileNotFound)
                                                                 End If 
                                                              End If
                                                           End Sub)
      finalTask.Wait()                                                                  
   End Sub
   
   Private Sub DisplayResult(wordCountTasks As Task())
   End Sub
End Module
' The example displays output like the following:
'       chapter2.txt               1,585 words
'       chapter1.txt               4,012 words
'       chapter5.txt               4,660 words
'       chapter3.txt               7,481 words
'       
'       4 files                    17738 total words
'       
'       1 tasks failed for the following reasons:
'          File not found:    1

呼叫接續工作的 Task.Wait 方法不允許它處理 antecedent 工作擲回的例外狀況,因此範例會檢查每個 antecedent 工作的 Task.Status 屬性,以判斷工作是否成功。The call to the continuation task's Task.Wait method does not allow it to handle exceptions thrown by the antecedent tasks, so the example examines the Task.Status property of each antecedent task to determine whether the task succeeded.

備註

tasks 陣列中的所有工作都已完成時(不論其完成狀態為何),ContinueWhenAll 方法都會執行 continuationAction 委派。The ContinueWhenAll method executes the continuationAction delegate when all tasks in the tasks array have completed, regardless of their completion status.

透過結構化例外狀況處理,接續工作無法使用由 tasks 陣列中的工作擲回的例外狀況。Exceptions thrown by tasks in the tasks array are not available to the continuation task through structured exception handling. 您可以藉由檢查 tasks 陣列中每個工作的 Task.Exception 屬性,判斷所擲回的例外狀況。You can determine which exceptions were thrown by examining the Task.Exception property of each task in the tasks array. 若要使用結構化例外狀況處理來處理 tasks 陣列中的工作所擲回的例外狀況,請呼叫 Task.WaitAll(Task[]) 方法。To use structured exception handling to handle exceptions thrown by tasks in the tasks array, call the Task.WaitAll(Task[]) method.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task ^> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task ContinueWhenAll (System.Threading.Tasks.Task[] tasks, Action<System.Threading.Tasks.Task[]> continuationAction, System.Threading.CancellationToken cancellationToken);
member this.ContinueWhenAll : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task[]> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function ContinueWhenAll (tasks As Task(), continuationAction As Action(Of Task()), cancellationToken As CancellationToken) As Task

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

-或--or- 已處置建立 cancellationTokenCancellationTokenSourceThe CancellationTokenSource that created cancellationToken has already been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

範例

下列範例會建立解除標記,它會傳遞至不同的工作,使用正則運算式來計算一組文字檔中的單字數目。The following example creates a cancellation token, which it passes to separate tasks that use a regular expression to count the number of words in a set of text files. 如果找不到檔案,則會設定解除標記。The cancellation token is set if a file cannot be found. 當所有的 antecedent 工作完成時,會使用 ContinueWhenAll(Task[], Action{Task[]}, CancellationToken) 方法來啟動顯示字數統計總計的工作。The ContinueWhenAll(Task[], Action{Task[]}, CancellationToken) method is used to launch a task that displays the total word count when all the antecedent tasks have completed. 如果已設定解除標記(表示已取消一個或多個工作),它會處理 AggregateException 例外狀況,並顯示錯誤訊息。If the cancellation token is set, which indicates that one or more tasks have been cancelled, it handles the AggregateException exception and displays an error message.

using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using System.Threading.Tasks;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string[] filenames = { "chapter1.txt", "chapter2.txt", 
                             "chapter3.txt", "chapter4.txt",
                             "chapter5.txt" };
      string pattern = @"\b\w+\b";
      var tasks = new List<Task>();  
      CancellationTokenSource source = new CancellationTokenSource();
      CancellationToken token = source.Token;
      int totalWords = 0;
        
      // Determine the number of words in each file.
      foreach (var filename in filenames)
         tasks.Add( Task.Factory.StartNew( fn => { token.ThrowIfCancellationRequested(); 

                                                   if (! File.Exists(fn.ToString())) {
                                                      source.Cancel();
                                                      token.ThrowIfCancellationRequested();
                                                   }
                                                   
                                                   StreamReader sr = new StreamReader(fn.ToString());
                                                   String content = sr.ReadToEnd();
                                                   sr.Close();
                                                   int words = Regex.Matches(content, pattern).Count;
                                                   Interlocked.Add(ref totalWords, words); 
                                                   Console.WriteLine("{0,-25} {1,6:N0} words", fn, words); }, 
                                           filename, token));

      var finalTask = Task.Factory.ContinueWhenAll(tasks.ToArray(), wordCountTasks => {
                                                    if (! token.IsCancellationRequested) 
                                                       Console.WriteLine("\n{0,-25} {1,6} total words\n", 
                                                                         String.Format("{0} files", wordCountTasks.Length), 
                                                                         totalWords); 
                                                   }, token); 
      try {                                                   
         finalTask.Wait();
      }
      catch (AggregateException ae) {
         foreach (Exception inner in ae.InnerExceptions)
            if (inner is TaskCanceledException)
               Console.WriteLine("\nFailure to determine total word count: a task was cancelled.");
            else
               Console.WriteLine("\nFailure caused by {0}", inner.GetType().Name);      
      }
      finally {
         source.Dispose();
      }
   }
}
// The example displays output like the following:
//       chapter2.txt               1,585 words
//       chapter1.txt               4,012 words
//       
//       Failure to determine total word count: a task was cancelled.
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading
Imports System.Threading.Tasks
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim filenames() As String= { "chapter1.txt", "chapter2.txt", 
                                   "chapter3.txt", "chapter4.txt",
                                   "chapter5.txt" }
      Dim pattern As String = "\b\w+\b"
      Dim tasks As New List(Of Task)()  
      Dim source As New CancellationTokenSource()
      Dim token As CancellationToken = source.Token
      Dim totalWords As Integer = 0
        
      ' Determine the number of words in each file.
      For Each filename In filenames
         tasks.Add( Task.Factory.StartNew( Sub(obj As Object)
                                              Dim fn As String = CStr(obj)
                                              token.ThrowIfCancellationRequested() 
                                              If Not File.Exists(fn) Then 
                                                 source.Cancel()
                                                 token.ThrowIfCancellationRequested()
                                              End If        
                                                   
                                              Dim sr As New StreamReader(fn.ToString())
                                              Dim content As String = sr.ReadToEnd()
                                              sr.Close()
                                              Dim words As Integer = Regex.Matches(content, pattern).Count
                                              Interlocked.Add(totalWords, words) 
                                              Console.WriteLine("{0,-25} {1,6:N0} words", fn, words) 
                                           End Sub, filename, token))
      Next
      
      Dim finalTask As Task = Task.Factory.ContinueWhenAll(tasks.ToArray(), 
                                                           Sub(wordCountTasks As Task())
                                                              If Not token.IsCancellationRequested Then 
                                                                 Console.WriteLine("\n{0,-25} {1,6} total words\n", 
                                                                                   String.Format("{0} files", wordCountTasks.Length), 
                                                                                   totalWords)
                                                              End If                      
                                                           End Sub, token) 
      Try                                                    
         finalTask.Wait()
      Catch ae As AggregateException 
         For Each inner In ae.InnerExceptions
            Console.WriteLine()
            If TypeOf inner Is TaskCanceledException
               Console.WriteLine("Failure to determine total word count: a task was cancelled.")
            Else
               Console.WriteLine("Failure caused by {0}", inner.GetType().Name)
            End If 
         Next           
      Finally
         source.Dispose()
      End Try                                                                     
   End Sub
End Module
' The example displays output like the following:
'       chapter2.txt               1,585 words
'       chapter1.txt               4,012 words
'       
'       Failure to determine total word count: a task was cancelled.

備註

tasks 陣列中的所有工作都已完成時,不論其完成狀態為何,這個方法都會執行 continuationAction 委派。This method executes the continuationAction delegate when all tasks in the tasks array have completed, regardless of their completion status.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task ^> ^> ^ continuationAction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);
public System.Threading.Tasks.Task ContinueWhenAll (System.Threading.Tasks.Task[] tasks, Action<System.Threading.Tasks.Task[]> continuationAction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);
member this.ContinueWhenAll : System.Threading.Tasks.Task[] * Action<System.Threading.Tasks.Task[]> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task
Public Function ContinueWhenAll (tasks As Task(), continuationAction As Action(Of Task()), continuationOptions As TaskContinuationOptions) As Task

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

continuationOptions 引數指定了無效的值。The continuationOptions argument specifies an invalid value.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task ^> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);
public System.Threading.Tasks.Task ContinueWhenAll (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.ContinueWhenAll : 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 ContinueWhenAll (tasks As Task(), continuationAction As Action(Of Task()), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task.

scheduler
TaskScheduler

用來排定新接續工作的物件。The object that is used to schedule the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

-或--or- scheduler 引數為 nullThe scheduler argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

continuationOptions 指定無效的 TaskContinuationOptions 值。continuationOptions specifies an invalid TaskContinuationOptions value.

提供的 CancellationToken 已經過處置。The provided CancellationToken has already been disposed.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult, typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<cli::array <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> ContinueWhenAll<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.ContinueWhenAll : 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 ContinueWhenAll(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 的結果類型。The type of the result of the antecedent tasks.

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task<TAntecedentResult>[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

scheduler
TaskScheduler

用來排定新接續工作的物件。The object that is used to schedule the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

-或--or- scheduler 引數為 nullThe scheduler argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

continuationOptions 引數指定了無效的值。The continuationOptions argument specifies an invalid value.

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

-或--or- 已處置建立 cancellationTokenCancellationTokenSourceThe CancellationTokenSource that created cancellationToken has already been disposed.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult, typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^, TResult> ^ continuationFunction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);
public System.Threading.Tasks.Task<TResult> ContinueWhenAll<TAntecedentResult,TResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>[],TResult> continuationFunction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);
member this.ContinueWhenAll : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>[], 'Result> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'Result>
Public Function ContinueWhenAll(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 的結果類型。The type of the result of the antecedent tasks.

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task<TAntecedentResult>[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

continuationOptions 引數指定了無效的值。The continuationOptions argument specifies an invalid value.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult, typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^, TResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<TResult> ContinueWhenAll<TAntecedentResult,TResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>[],TResult> continuationFunction, System.Threading.CancellationToken cancellationToken);
member this.ContinueWhenAll : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>[], 'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Public Function ContinueWhenAll(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 的結果類型。The type of the result of the antecedent tasks.

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task<TAntecedentResult>[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

-或--or- 已處置建立 cancellationTokenCancellationTokenSourceThe CancellationTokenSource that created cancellationToken has already been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult, typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Func<cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^, TResult> ^ continuationFunction);
public System.Threading.Tasks.Task<TResult> ContinueWhenAll<TAntecedentResult,TResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Func<System.Threading.Tasks.Task<TAntecedentResult>[],TResult> continuationFunction);
member this.ContinueWhenAll : System.Threading.Tasks.Task<'AntecedentResult>[] * Func<System.Threading.Tasks.Task<'AntecedentResult>[], 'Result> -> System.Threading.Tasks.Task<'Result>
Public Function ContinueWhenAll(Of TAntecedentResult, TResult) (tasks As Task(Of TAntecedentResult)(), continuationFunction As Func(Of Task(Of TAntecedentResult)(), TResult)) As Task(Of TResult)

類型參數

TAntecedentResult

前項 tasks 的結果類型。The type of the result of the antecedent tasks.

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task<TAntecedentResult>[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Action<cli::array <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 ContinueWhenAll<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.ContinueWhenAll : 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 ContinueWhenAll(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 的結果型別。The type of the result of the antecedent tasks.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task<TAntecedentResult>[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

scheduler
TaskScheduler

用來排定新接續工作的物件。The object that is used to schedule the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

-或--or- scheduler 引數為 nullThe scheduler argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

continuationOptions 指定無效的 TaskContinuationOptions 值。continuationOptions specifies an invalid TaskContinuationOptions value.

提供的 CancellationToken 已經過處置。The provided CancellationToken has already been disposed.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^> ^ continuationAction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);
public System.Threading.Tasks.Task ContinueWhenAll<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Action<System.Threading.Tasks.Task<TAntecedentResult>[]> continuationAction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);
member this.ContinueWhenAll : System.Threading.Tasks.Task<'AntecedentResult>[] * Action<System.Threading.Tasks.Task<'AntecedentResult>[]> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task
Public Function ContinueWhenAll(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult)()), continuationOptions As TaskContinuationOptions) As Task

類型參數

TAntecedentResult

前項 tasks 的結果型別。The type of the result of the antecedent tasks.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task<TAntecedentResult>[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

continuationOptions 引數指定了無效的值。The continuationOptions argument specifies an invalid value.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task ContinueWhenAll<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Action<System.Threading.Tasks.Task<TAntecedentResult>[]> continuationAction, System.Threading.CancellationToken cancellationToken);
member this.ContinueWhenAll : System.Threading.Tasks.Task<'AntecedentResult>[] * Action<System.Threading.Tasks.Task<'AntecedentResult>[]> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function ContinueWhenAll(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult)()), cancellationToken As CancellationToken) As Task

類型參數

TAntecedentResult

前項 tasks 的結果型別。The type of the result of the antecedent tasks.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task<TAntecedentResult>[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

-或--or- 已處置建立 cancellationTokenCancellationTokenSourceThe CancellationTokenSource that created cancellationToken has already been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TAntecedentResult>
 System::Threading::Tasks::Task ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^ tasks, Action<cli::array <System::Threading::Tasks::Task<TAntecedentResult> ^> ^> ^ continuationAction);
public System.Threading.Tasks.Task ContinueWhenAll<TAntecedentResult> (System.Threading.Tasks.Task<TAntecedentResult>[] tasks, Action<System.Threading.Tasks.Task<TAntecedentResult>[]> continuationAction);
member this.ContinueWhenAll : System.Threading.Tasks.Task<'AntecedentResult>[] * Action<System.Threading.Tasks.Task<'AntecedentResult>[]> -> System.Threading.Tasks.Task
Public Function ContinueWhenAll(Of TAntecedentResult) (tasks As Task(Of TAntecedentResult)(), continuationAction As Action(Of Task(Of TAntecedentResult)())) As Task

類型參數

TAntecedentResult

前項 tasks 的結果類型。The type of the result of the antecedent tasks.

參數

tasks
Task<TAntecedentResult>[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationAction
Action<Task<TAntecedentResult>[]>

tasks 陣列中的所有工作都已經完成時,要執行的動作委派。The action delegate to execute when all tasks in the tasks array have completed.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationAction 引數為 nullThe continuationAction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<cli::array <System::Threading::Tasks::Task ^> ^, TResult> ^ continuationFunction);
public System.Threading.Tasks.Task<TResult> ContinueWhenAll<TResult> (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task[],TResult> continuationFunction);
member this.ContinueWhenAll : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task[], 'Result> -> System.Threading.Tasks.Task<'Result>
Public Function ContinueWhenAll(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task(), TResult)) As Task(Of TResult)

類型參數

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<cli::array <System::Threading::Tasks::Task ^> ^, TResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<TResult> ContinueWhenAll<TResult> (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task[],TResult> continuationFunction, System.Threading.CancellationToken cancellationToken);
member this.ContinueWhenAll : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task[], 'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Public Function ContinueWhenAll(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task(), TResult), cancellationToken As CancellationToken) As Task(Of TResult)

類型參數

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

-或--or- 已處置建立 cancellationTokenCancellationTokenSourceThe CancellationTokenSource that created cancellationToken has already been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<cli::array <System::Threading::Tasks::Task ^> ^, TResult> ^ continuationFunction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);
public System.Threading.Tasks.Task<TResult> ContinueWhenAll<TResult> (System.Threading.Tasks.Task[] tasks, Func<System.Threading.Tasks.Task[],TResult> continuationFunction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);
member this.ContinueWhenAll : System.Threading.Tasks.Task[] * Func<System.Threading.Tasks.Task[], 'Result> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'Result>
Public Function ContinueWhenAll(Of TResult) (tasks As Task(), continuationFunction As Func(Of Task(), TResult), continuationOptions As TaskContinuationOptions) As Task(Of TResult)

類型參數

TResult

continuationFunction 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

傳回

新的接續工作。The new continuation task.

例外狀況

已處置之 tasks 陣列中的項目。An element in the tasks array has been disposed.

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

continuationOptions 引數指定了無效的值。The continuationOptions argument specifies an invalid value.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

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

當一組指定的工作已完成時,建立啟動的接續工作。Creates a continuation task that starts when a set of specified tasks has completed.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ ContinueWhenAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, Func<cli::array <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> ContinueWhenAll<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.ContinueWhenAll : 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 ContinueWhenAll(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 委派傳回,且與建立之工作相關聯的結果的類型。The type of the result that is returned by the continuationFunction delegate and associated with the created task.

參數

tasks
Task[]

要接續之工作的所在陣列。The array of tasks from which to continue.

continuationFunction
Func<Task[],TResult>

tasks 陣列中的所有工作都已經完成時,要以非同步方式執行的函式委派。The function delegate to execute asynchronously when all tasks in the tasks array have completed.

cancellationToken
CancellationToken

要指派給新接續工作的取消語彙基元。The cancellation token to assign to the new continuation task.

continuationOptions
TaskContinuationOptions

列舉值的位元組合,這些值會控制新接續工作的行為。A bitwise combination of the enumeration values that control the behavior of the new continuation task. 不支援 NotOn* 和 OnlyOn* 成員。The NotOn* and OnlyOn* members are not supported.

scheduler
TaskScheduler

用來排定新接續工作的物件。The object that is used to schedule the new continuation task.

傳回

新的接續工作。The new continuation task.

例外狀況

tasks 陣列為 nullThe tasks array is null.

-或--or- continuationFunction 引數為 nullThe continuationFunction argument is null.

-或--or- scheduler 引數為 nullThe scheduler argument is null.

tasks 陣列為空白或包含 null 值。The tasks array is empty or contains a null value.

continuationOptions 指定無效的 TaskContinuationOptions 值。continuationOptions specifies an invalid TaskContinuationOptions value.

提供的 CancellationToken 已經過處置。The provided CancellationToken has already been disposed.

備註

NotOn* 和 OnlyOn* TaskContinuationOptions,其會限制將執行接續的 TaskStatus 狀態,與 ContinueWhenAll不合法。The NotOn* and OnlyOn* TaskContinuationOptions, which constrain for which TaskStatus states a continuation will be executed, are illegal with ContinueWhenAll.

另請參閱

適用於