Task.WhenAll Methode

Definition

Namespace:
System.Threading.Tasks
Assemblys:
System.Threading.Tasks.dll, mscorlib.dll, netstandard.dll, System.Runtime.dll

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle angegebenen Aufgaben abgeschlossen sind.Creates a task that will complete when all of the supplied tasks have completed.

Überlädt

WhenAll(IEnumerable<Task>)

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task-Objekte in einer aufzählbaren Sammlung abgeschlossen sind.Creates a task that will complete when all of the Task objects in an enumerable collection have completed.
WhenAll(Task[])

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task-Objekte in einem Array abgeschlossen sind.Creates a task that will complete when all of the Task objects in an array have completed.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task<TResult>-Objekte in einer aufzählbaren Sammlung abgeschlossen sind.Creates a task that will complete when all of the Task<TResult> objects in an enumerable collection have completed.
WhenAll<TResult>(Task<TResult>[])

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task<TResult>-Objekte in einem Array abgeschlossen sind.Creates a task that will complete when all of the Task<TResult> objects in an array have completed.

WhenAll(IEnumerable<Task>)

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task-Objekte in einer aufzählbaren Sammlung abgeschlossen sind.Creates a task that will complete when all of the Task objects in an enumerable collection have completed.

public:
 static System::Threading::Tasks::Task ^ WhenAll(System::Collections::Generic::IEnumerable<System::Threading::Tasks::Task ^> ^ tasks);
public static System.Threading.Tasks.Task WhenAll (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task> tasks);
static member WhenAll : seq<System.Threading.Tasks.Task> -> System.Threading.Tasks.Task
Public Shared Function WhenAll (tasks As IEnumerable(Of Task)) As Task

Parameter

tasks
IEnumerable<Task>

Die Aufgaben, auf deren Abschluss gewartet werden soll.The tasks to wait on for completion.

Gibt zurück

Task

Eine Aufgabe, die den Abschluss aller angegebenen Aufgaben darstellt.A task that represents the completion of all of the supplied tasks.

Ausnahmen

ArgumentNullException

Das tasks-Argument lautete null.The tasks argument was null.

ArgumentException

Die tasks-Auflistung enthält eine null-Aufgabe.The tasks collection contained a null task.

Beispiele

Im folgenden Beispiel wird eine Reihe von Tasks erstellt, mit denen die URLs in einem Array gepingt werden.The following example creates a set of tasks that ping the URLs in an array. Die Aufgaben werden in einer List<Task>-Auflistung gespeichert, die an die WhenAll(IEnumerable<Task>)-Methode übermittelt wird.The tasks are stored in a List<Task> collection that is passed to the WhenAll(IEnumerable<Task>) method. Nachdem der Wait-Methode aufgerufen wurde, wird sichergestellt, dass alle Threads abgeschlossen wurden. in diesem Beispiel wird die Eigenschaft Task.Status untersucht, um zu bestimmen, ob Tasks fehlgeschlagen sind.After the call to the Wait method ensures that all threads have completed, the example examines the Task.Status property to determine whether any tasks have faulted.

using System;
using System.Collections.Generic;
using System.Net.NetworkInformation;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      int failed = 0;
      var tasks = new List<Task>();
      String[] urls = { "www.adatum.com", "www.cohovineyard.com",
                        "www.cohowinery.com", "www.northwindtraders.com",
                        "www.contoso.com" };
      
      foreach (var value in urls) {
         var url = value;
         tasks.Add(Task.Run( () => { var png = new Ping();
                                     try {
                                        var reply = png.Send(url);
                                        if (! (reply.Status == IPStatus.Success)) {
                                           Interlocked.Increment(ref failed);
                                           throw new TimeoutException("Unable to reach " + url + ".");
                                        }
                                     }
                                     catch (PingException) {
                                        Interlocked.Increment(ref failed);
                                        throw;
                                     }
                                   }));
      }
      Task t = Task.WhenAll(tasks);
      try {
         t.Wait();
      }
      catch {}   

      if (t.Status == TaskStatus.RanToCompletion)
         Console.WriteLine("All ping attempts succeeded.");
      else if (t.Status == TaskStatus.Faulted)
         Console.WriteLine("{0} ping attempts failed", failed);      
   }
}
// The example displays output like the following:
//       5 ping attempts failed

Imports System.Collections.Generic
Imports System.Net.NetworkInformation
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim failed As Integer = 0
      Dim tasks As New List(Of Task)()
      Dim urls() As String = { "www.adatum.com", "www.cohovineyard.com",
                              "www.cohowinery.com", "www.northwindtraders.com",
                              "www.contoso.com" }
      
      For Each value In urls
         Dim url As String = value
         tasks.Add(Task.Run( Sub()
                                Dim png As New Ping()
                                Try
                                   Dim reply = png.Send(url)
                                   If Not reply.Status = IPStatus.Success Then
                                      Interlocked.Increment(failed)
                                      Throw New TimeoutException("Unable to reach " + url + ".")
                                   End If
                                   Catch e As PingException
                                      Interlocked.Increment(failed)
                                      Throw
                                   End Try
                             End Sub))
      Next
      Dim t As Task = Task.WhenAll(tasks)
      Try
         t.Wait()
      Catch
      End Try   

      If t.Status = TaskStatus.RanToCompletion
         Console.WriteLine("All ping attempts succeeded.")
      ElseIf t.Status = TaskStatus.Faulted
         Console.WriteLine("{0} ping attempts failed", failed)      
      End If
   End Sub
End Module
' The example displays output like the following:
'     5 ping attempts failed

Hinweise

Die über Ladungen der WhenAll-Methode, die ein Task-Objekt zurückgeben, werden in der Regel aufgerufen, wenn Sie am Status eines Satzes von Tasks oder in den Ausnahmen interessiert sind, die von einem Satz von Tasks ausgelöst werden.The overloads of the WhenAll method that return a Task object are typically called when you are interested in the status of a set of tasks or in the exceptions thrown by a set of tasks.

Hinweis

Durch den Aufruf der WhenAll(IEnumerable<Task>)-Methode wird der aufrufende Thread nicht blockiert.The call to WhenAll(IEnumerable<Task>) method does not block the calling thread.

Wenn eine der angegebenen Aufgaben in einem fehlerhaften Zustand abgeschlossen wird, wird die zurückgegebene Aufgabe auch in einem Faulted-Status abgeschlossen, wobei ihre Ausnahmen die Aggregation des Satzes von nicht umschließenden Ausnahmen aus den einzelnen bereitgestellten Tasks enthalten.If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state, where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.

Wenn keine der angegebenen Tasks einen Fehler verursacht hat, aber mindestens einer davon abgebrochen wurde, endet die zurückgegebene Aufgabe mit dem Zustand "Canceled".If none of the supplied tasks faulted but at least one of them was canceled, the returned task will end in the Canceled state.

Wenn keiner der Tasks einen Fehler verursacht hat und keine der Aufgaben abgebrochen wurde, endet die resultierende Aufgabe mit dem Zustand "RanToCompletion".If none of the tasks faulted and none of the tasks were canceled, the resulting task will end in the RanToCompletion state.

Wenn das angegebene Array/Enumerable keine Aufgaben enthält, wechselt die zurückgegebene Aufgabe sofort in den Zustand "RanToCompletion", bevor Sie an den Aufrufer zurückgegeben wird.If the supplied array/enumerable contains no tasks, the returned task will immediately transition to a RanToCompletion state before it's returned to the caller.

WhenAll(Task[])

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task-Objekte in einem Array abgeschlossen sind.Creates a task that will complete when all of the Task objects in an array have completed.

public:
 static System::Threading::Tasks::Task ^ WhenAll(... cli::array <System::Threading::Tasks::Task ^> ^ tasks);
public static System.Threading.Tasks.Task WhenAll (params System.Threading.Tasks.Task[] tasks);
static member WhenAll : System.Threading.Tasks.Task[] -> System.Threading.Tasks.Task
Public Shared Function WhenAll (ParamArray tasks As Task()) As Task

Parameter

tasks
Task[]

Die Aufgaben, auf deren Abschluss gewartet werden soll.The tasks to wait on for completion.

Gibt zurück

Task

Eine Aufgabe, die den Abschluss aller angegebenen Aufgaben darstellt.A task that represents the completion of all of the supplied tasks.

Ausnahmen

ArgumentNullException

Das tasks-Argument lautete null.The tasks argument was null.

ArgumentException

Das tasks-Array enthielt eine null-Aufgabe.The tasks array contained a null task.

Beispiele

Im folgenden Beispiel wird eine Reihe von Tasks erstellt, mit denen die URLs in einem Array gepingt werden.The following example creates a set of tasks that ping the URLs in an array. Die Aufgaben werden in einer List<Task>-Auflistung gespeichert, die in ein Array konvertiert und an die WhenAll(IEnumerable<Task>)-Methode übermittelt wird.The tasks are stored in a List<Task> collection that is converted to an array and passed to the WhenAll(IEnumerable<Task>) method. Nachdem der Wait-Methode aufgerufen wurde, wird sichergestellt, dass alle Threads abgeschlossen wurden. in diesem Beispiel wird die Eigenschaft Task.Status untersucht, um zu bestimmen, ob Tasks fehlgeschlagen sind.After the call to the Wait method ensures that all threads have completed, the example examines the Task.Status property to determine whether any tasks have faulted.

using System;
using System.Collections.Generic;
using System.Net.NetworkInformation;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static async Task Main()
   {
      int failed = 0;
      var tasks = new List<Task>();
      String[] urls = { "www.adatum.com", "www.cohovineyard.com",
                        "www.cohowinery.com", "www.northwindtraders.com",
                        "www.contoso.com" };
      
      foreach (var value in urls) {
         var url = value;
         tasks.Add(Task.Run( () => { var png = new Ping();
                                     try {
                                        var reply = png.Send(url);
                                        if (! (reply.Status == IPStatus.Success)) {
                                           Interlocked.Increment(ref failed);
                                           throw new TimeoutException("Unable to reach " + url + ".");
                                        }
                                     }
                                     catch (PingException) {
                                        Interlocked.Increment(ref failed);
                                        throw;
                                     }
                                   }));
      }
      Task t = Task.WhenAll(tasks.ToArray());
      try {
         await t;
      }
      catch {}   

      if (t.Status == TaskStatus.RanToCompletion)
         Console.WriteLine("All ping attempts succeeded.");
      else if (t.Status == TaskStatus.Faulted)
         Console.WriteLine("{0} ping attempts failed", failed);      
   }
}
// The example displays output like the following:
//       5 ping attempts failed

Imports System.Collections.Generic
Imports System.Net.NetworkInformation
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim failed As Integer = 0
      Dim tasks As New List(Of Task)()
      Dim urls() As String = { "www.adatum.com", "www.cohovineyard.com",
                              "www.cohowinery.com", "www.northwindtraders.com",
                              "www.contoso.com" }
      
      For Each value In urls
         Dim url As String = value
         tasks.Add(Task.Run( Sub()
                                Dim png As New Ping()
                                Try
                                   Dim reply = png.Send(url)
                                   If Not reply.Status = IPStatus.Success Then
                                      Interlocked.Increment(failed)
                                      Throw New TimeoutException("Unable to reach " + url + ".")
                                   End If
                                   Catch e As PingException
                                      Interlocked.Increment(failed)
                                      Throw
                                   End Try
                             End Sub))
      Next
      Dim t As Task = Task.WhenAll(tasks.ToArray())
      Try
         t.Wait()
      Catch
      End Try   

      If t.Status = TaskStatus.RanToCompletion
         Console.WriteLine("All ping attempts succeeded.")
      ElseIf t.Status = TaskStatus.Faulted
         Console.WriteLine("{0} ping attempts failed", failed)      
      End If
   End Sub
End Module
' The example displays output like the following:
'     5 ping attempts failed

Hinweise

Die über Ladungen der WhenAll-Methode, die ein Task-Objekt zurückgeben, werden in der Regel aufgerufen, wenn Sie am Status eines Satzes von Tasks oder in den Ausnahmen interessiert sind, die von einem Satz von Tasks ausgelöst werden.The overloads of the WhenAll method that return a Task object are typically called when you are interested in the status of a set of tasks or in the exceptions thrown by a set of tasks.

Hinweis

Durch den Aufruf der WhenAll(Task[])-Methode wird der aufrufende Thread nicht blockiert.The call to WhenAll(Task[]) method does not block the calling thread.

Wenn eine der angegebenen Aufgaben in einem fehlerhaften Zustand abgeschlossen wird, wird die zurückgegebene Aufgabe auch in einem Faulted-Status abgeschlossen, wobei ihre Ausnahmen die Aggregation des Satzes von nicht umschließenden Ausnahmen aus den einzelnen bereitgestellten Tasks enthalten.If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state, where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.

Wenn keine der angegebenen Tasks einen Fehler verursacht hat, aber mindestens einer davon abgebrochen wurde, endet die zurückgegebene Aufgabe mit dem Zustand "Canceled".If none of the supplied tasks faulted but at least one of them was canceled, the returned task will end in the Canceled state.

Wenn keiner der Tasks einen Fehler verursacht hat und keine der Aufgaben abgebrochen wurde, endet die resultierende Aufgabe mit dem Zustand "RanToCompletion".If none of the tasks faulted and none of the tasks were canceled, the resulting task will end in the RanToCompletion state.

Wenn das angegebene Array/Enumerable keine Aufgaben enthält, wechselt die zurückgegebene Aufgabe sofort in den Zustand "RanToCompletion", bevor Sie an den Aufrufer zurückgegeben wird.If the supplied array/enumerable contains no tasks, the returned task will immediately transition to a RanToCompletion state before it's returned to the caller.

WhenAll<TResult>(IEnumerable<Task<TResult>>)

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task<TResult>-Objekte in einer aufzählbaren Sammlung abgeschlossen sind.Creates a task that will complete when all of the Task<TResult> objects in an enumerable collection have completed.

public:
generic <typename TResult>
 static System::Threading::Tasks::Task<cli::array <TResult> ^> ^ WhenAll(System::Collections::Generic::IEnumerable<System::Threading::Tasks::Task<TResult> ^> ^ tasks);
public static System.Threading.Tasks.Task<TResult[]> WhenAll<TResult> (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task<TResult>> tasks);
static member WhenAll : seq<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task<'Result[]>
Public Shared Function WhenAll(Of TResult) (tasks As IEnumerable(Of Task(Of TResult))) As Task(Of TResult())

Typparameter

TResult

Der Typ der abgeschlossenen Aufgabe.The type of the completed task.

Parameter

tasks
IEnumerable<Task<TResult>>

Die Aufgaben, auf deren Abschluss gewartet werden soll.The tasks to wait on for completion.

Gibt zurück

Task<TResult[]>

Eine Aufgabe, die den Abschluss aller angegebenen Aufgaben darstellt.A task that represents the completion of all of the supplied tasks.

Ausnahmen

ArgumentNullException

Das tasks-Argument lautete null.The tasks argument was null.

ArgumentException

Die tasks-Auflistung enthielt eine null-Aufgabe.The tasks collection contained a null task.

Beispiele

Im folgenden Beispiel werden zehn Aufgaben erstellt, von denen jede einen Zufallszahlengenerator instanziiert, der 1.000 Zufallszahlen zwischen 1 und 1.000 erstellt und ihren Mittelwert berechnet.The following example creates ten tasks, each of which instantiates a random number generator that creates 1,000 random numbers between 1 and 1,000 and computes their mean. Die Delay(Int32)-Methode wird verwendet, um die Instanziierung der Zufallszahlengeneratoren so zu verzögern, dass Sie nicht mit identischen Seed-Werten erstellt werden.The Delay(Int32) method is used to delay instantiation of the random number generators so that they are not created with identical seed values. Der-Befehl für die WhenAll-Methode gibt dann ein Int64-Array zurück, das den von jedem Task berechneten Mittelwert enthält.The call to the WhenAll method then returns an Int64 array that contains the mean computed by each task. Diese werden dann verwendet, um den allgemeinen Mittelwert zu berechnen.These are then used to calculate the overall mean.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var tasks = new List<Task<long>>();
      for (int ctr = 1; ctr <= 10; ctr++) {
         int delayInterval = 18 * ctr;
         tasks.Add(Task.Run(async () => { long total = 0;
                                          await Task.Delay(delayInterval);
                                          var rnd = new Random();
                                          // Generate 1,000 random numbers.
                                          for (int n = 1; n <= 1000; n++)
                                             total += rnd.Next(0, 1000);
                                          return total; } ));
      }
      var continuation = Task.WhenAll(tasks);
      try {
         continuation.Wait();
      }
      catch (AggregateException)
      { }
   
      if (continuation.Status == TaskStatus.RanToCompletion) {
         long grandTotal = 0;
         foreach (var result in continuation.Result) {
            grandTotal += result;
            Console.WriteLine("Mean: {0:N2}, n = 1,000", result/1000.0);
         }
   
         Console.WriteLine("\nMean of Means: {0:N2}, n = 10,000",
                           grandTotal/10000);
      }
      // Display information on faulted tasks.
      else {
         foreach (var t in tasks) {
            Console.WriteLine("Task {0}: {1}", t.Id, t.Status);
         }
      }
   }
}
// The example displays output like the following:
//       Mean: 506.34, n = 1,000
//       Mean: 504.69, n = 1,000
//       Mean: 489.32, n = 1,000
//       Mean: 505.96, n = 1,000
//       Mean: 515.31, n = 1,000
//       Mean: 499.94, n = 1,000
//       Mean: 496.92, n = 1,000
//       Mean: 508.58, n = 1,000
//       Mean: 494.88, n = 1,000
//       Mean: 493.53, n = 1,000
//
//       Mean of Means: 501.55, n = 10,000

Imports System.Collections.Generic
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tasks As New List(Of Task(Of Long))()
      For ctr As Integer = 1 To 10
         Dim delayInterval As Integer = 18 * ctr
         tasks.Add(Task.Run(Async Function()
                               Dim total As Long = 0
                               Await Task.Delay(delayInterval)
                               Dim rnd As New Random()
                               ' Generate 1,000 random numbers.
                               For n As Integer = 1 To 1000
                                  total += rnd.Next(0, 1000)
                               Next
                               Return total
                            End Function))
      Next
      Dim continuation = Task.WhenAll(tasks)
      Try
         continuation.Wait()
      Catch ae As AggregateException
      End Try
      
      If continuation.Status = TaskStatus.RanToCompletion Then
         Dim grandTotal As Long = 0
         For Each result in continuation.Result
            grandTotal += result
            Console.WriteLine("Mean: {0:N2}, n = 1,000", result/1000)
         Next
         Console.WriteLine()
         Console.WriteLine("Mean of Means: {0:N2}, n = 10,000",
                           grandTotal/10000)
      ' Display information on faulted tasks.
      Else 
         For Each t In tasks
            Console.WriteLine("Task {0}: {1}", t.Id, t.Status)
         Next
      End If
   End Sub
End Module
' The example displays output like the following:
'       Mean: 506.34, n = 1,000
'       Mean: 504.69, n = 1,000
'       Mean: 489.32, n = 1,000
'       Mean: 505.96, n = 1,000
'       Mean: 515.31, n = 1,000
'       Mean: 499.94, n = 1,000
'       Mean: 496.92, n = 1,000
'       Mean: 508.58, n = 1,000
'       Mean: 494.88, n = 1,000
'       Mean: 493.53, n = 1,000
'
'       Mean of Means: 501.55, n = 10,000

In diesem Fall werden die zehn einzelnen Aufgaben in einem List<T>-Objekt gespeichert.In this case, the ten individual tasks are stored in a List<T> object. List<T> implementiert die IEnumerable<T>-Schnittstelle.List<T> implements the IEnumerable<T> interface.

Hinweise

Durch den Aufruf der WhenAll<TResult>(IEnumerable<Task<TResult>>)-Methode wird der aufrufende Thread nicht blockiert.The call to WhenAll<TResult>(IEnumerable<Task<TResult>>) method does not block the calling thread. Ein Aufruf der zurückgegebenen Result-Eigenschaft blockiert jedoch den aufrufenden Thread.However, a call to the returned Result property does block the calling thread.

Wenn eine der angegebenen Aufgaben in einem fehlerhaften Zustand abgeschlossen wird, wird die zurückgegebene Aufgabe auch in einem Faulted-Status abgeschlossen, wobei ihre Ausnahmen die Aggregation des Satzes von nicht umschließenden Ausnahmen aus den einzelnen bereitgestellten Tasks enthalten.If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state, where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.

Wenn keine der angegebenen Tasks einen Fehler verursacht hat, aber mindestens einer davon abgebrochen wurde, endet die zurückgegebene Aufgabe mit dem Zustand "Canceled".If none of the supplied tasks faulted but at least one of them was canceled, the returned task will end in the Canceled state.

Wenn keiner der Tasks einen Fehler verursacht hat und keine der Aufgaben abgebrochen wurde, endet die resultierende Aufgabe mit dem Zustand "RanToCompletion".If none of the tasks faulted and none of the tasks were canceled, the resulting task will end in the RanToCompletion state. Die Task<TResult>.Result-Eigenschaft der zurückgegebenen Aufgabe wird auf ein Array festgelegt, das alle Ergebnisse der angegebenen Aufgaben in derselben Reihenfolge enthält, in der Sie bereitgestellt wurden (z. b. wenn das Eingabe Aufgaben Array T1, T2, T3 enthielt, gibt die Task<TResult>.Result-Eigenschaft der Ausgabe Aufgabe einen TResult[] WH zurück). ere arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result).The Task<TResult>.Result property of the returned task will be set to an array containing all of the results of the supplied tasks in the same order as they were provided (e.g. if the input tasks array contained t1, t2, t3, the output task's Task<TResult>.Result property will return an TResult[] where arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result).

Wenn das tasks-Argument keine Aufgaben enthält, wechselt die zurückgegebene Aufgabe sofort in den Zustand "RanToCompletion", bevor Sie an den Aufrufer zurückgegeben wird.If the tasks argument contains no tasks, the returned task will immediately transition to a RanToCompletion state before it's returned to the caller. Der zurückgegebene TResult[] ist ein Array von 0 Elementen.The returned TResult[] will be an array of 0 elements.

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

Erstellt eine Aufgabe, die abgeschlossen wird, wenn alle Task<TResult>-Objekte in einem Array abgeschlossen sind.Creates a task that will complete when all of the Task<TResult> objects in an array have completed.

public:
generic <typename TResult>
 static System::Threading::Tasks::Task<cli::array <TResult> ^> ^ WhenAll(... cli::array <System::Threading::Tasks::Task<TResult> ^> ^ tasks);
public static System.Threading.Tasks.Task<TResult[]> WhenAll<TResult> (params System.Threading.Tasks.Task<TResult>[] tasks);
static member WhenAll : System.Threading.Tasks.Task<'Result>[] -> System.Threading.Tasks.Task<'Result[]>
Public Shared Function WhenAll(Of TResult) (ParamArray tasks As Task(Of TResult)()) As Task(Of TResult())

Typparameter

TResult

Der Typ der abgeschlossenen Aufgabe.The type of the completed task.

Parameter

tasks
Task<TResult>[]

Die Aufgaben, auf deren Abschluss gewartet werden soll.The tasks to wait on for completion.

Gibt zurück

Task<TResult[]>

Eine Aufgabe, die den Abschluss aller angegebenen Aufgaben darstellt.A task that represents the completion of all of the supplied tasks.

Ausnahmen

ArgumentNullException

Das tasks-Argument lautete null.The tasks argument was null.

ArgumentException

Das tasks-Array enthielt eine null-Aufgabe.The tasks array contained a null task.

Beispiele

Im folgenden Beispiel werden zehn Aufgaben erstellt, von denen jede einen Zufallszahlengenerator instanziiert, der 1.000 Zufallszahlen zwischen 1 und 1.000 erstellt und ihren Mittelwert berechnet.The following example creates ten tasks, each of which instantiates a random number generator that creates 1,000 random numbers between 1 and 1,000 and computes their mean. In diesem Fall werden die zehn einzelnen Aufgaben in einem Task<Int64>-Array gespeichert.In this case, the ten individual tasks are stored in a Task<Int64> array. Die Delay(Int32)-Methode wird verwendet, um die Instanziierung der Zufallszahlengeneratoren so zu verzögern, dass Sie nicht mit identischen Seed-Werten erstellt werden.The Delay(Int32) method is used to delay instantiation of the random number generators so that they are not created with identical seed values. Der-Befehl für die WhenAll-Methode gibt dann ein Int64-Array zurück, das den von jedem Task berechneten Mittelwert enthält.The call to the WhenAll method then returns an Int64 array that contains the mean computed by each task. Diese werden dann verwendet, um den allgemeinen Mittelwert zu berechnen.These are then used to calculate the overall mean.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var tasks = new Task<long>[10];
      for (int ctr = 1; ctr <= 10; ctr++) {
         int delayInterval = 18 * ctr;
         tasks[ctr - 1] = Task.Run(async () => { long total = 0;
                                                 await Task.Delay(delayInterval);
                                                 var rnd = new Random();
                                                 // Generate 1,000 random numbers.
                                                 for (int n = 1; n <= 1000; n++)
                                                    total += rnd.Next(0, 1000);

                                                 return total; } );
      }
      var continuation = Task.WhenAll(tasks);
      try {
         continuation.Wait();
      }
      catch (AggregateException)
      {}
   
      if (continuation.Status == TaskStatus.RanToCompletion) {
         long grandTotal = 0;
         foreach (var result in continuation.Result) {
            grandTotal += result;
            Console.WriteLine("Mean: {0:N2}, n = 1,000", result/1000.0);
         }
   
         Console.WriteLine("\nMean of Means: {0:N2}, n = 10,000",
                           grandTotal/10000);
      }
      // Display information on faulted tasks.
      else { 
         foreach (var t in tasks)
            Console.WriteLine("Task {0}: {1}", t.Id, t.Status);
      }
   
   }
}
// The example displays output like the following:
//       Mean: 506.38, n = 1,000
//       Mean: 501.01, n = 1,000
//       Mean: 505.36, n = 1,000
//       Mean: 492.00, n = 1,000
//       Mean: 508.36, n = 1,000
//       Mean: 503.99, n = 1,000
//       Mean: 504.95, n = 1,000
//       Mean: 508.58, n = 1,000
//       Mean: 490.23, n = 1,000
//       Mean: 501.59, n = 1,000
//
//       Mean of Means: 502.00, n = 10,000

Imports System.Collections.Generic
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tasks(9) As Task(Of Long)
      For ctr As Integer = 1 To 10
         Dim delayInterval As Integer = 18 * ctr
         tasks(ctr - 1) =Task.Run(Async Function()
                                     Dim total As Long = 0
                                     Await Task.Delay(delayInterval)
                                     Dim rnd As New Random()
                                     ' Generate 1,000 random numbers.
                                     For n As Integer = 1 To 1000
                                        total += rnd.Next(0, 1000)
                                     Next
                                     Return total
                                  End Function)
      Next
      Dim continuation = Task.WhenAll(tasks)
      Try
         continuation.Wait()
      Catch ae As AggregateException
      End Try
         
      If continuation.Status = TaskStatus.RanToCompletion Then
         Dim grandTotal As Long = 0
         For Each result in continuation.Result
            grandTotal += result
            Console.WriteLine("Mean: {0:N2}, n = 1,000", result/1000)
         Next
         Console.WriteLine()
         Console.WriteLine("Mean of Means: {0:N2}, n = 10,000",
                           grandTotal/10000)
      ' Display information on faulted tasks.
      Else 
         For Each t In tasks
            Console.WriteLine("Task {0}: {1}", t.Id, t.Status)
         Next
      End If
   End Sub
End Module
' The example displays output like the following:
'       Mean: 506.38, n = 1,000
'       Mean: 501.01, n = 1,000
'       Mean: 505.36, n = 1,000
'       Mean: 492.00, n = 1,000
'       Mean: 508.36, n = 1,000
'       Mean: 503.99, n = 1,000
'       Mean: 504.95, n = 1,000
'       Mean: 508.58, n = 1,000
'       Mean: 490.23, n = 1,000
'       Mean: 501.59, n = 1,000
'
'       Mean of Means: 502.00, n = 10,000

Hinweise

Durch den Aufruf der WhenAll<TResult>(Task<TResult>[])-Methode wird der aufrufende Thread nicht blockiert.The call to WhenAll<TResult>(Task<TResult>[]) method does not block the calling thread. Ein Aufruf der zurückgegebenen Result-Eigenschaft blockiert jedoch den aufrufenden Thread.However, a call to the returned Result property does block the calling thread.

Wenn eine der angegebenen Aufgaben in einem fehlerhaften Zustand abgeschlossen wird, wird die zurückgegebene Aufgabe auch in einem Faulted-Status abgeschlossen, wobei ihre Ausnahmen die Aggregation des Satzes von nicht umschließenden Ausnahmen aus den einzelnen bereitgestellten Tasks enthalten.If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state, where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.

Wenn keine der angegebenen Tasks einen Fehler verursacht hat, aber mindestens einer davon abgebrochen wurde, endet die zurückgegebene Aufgabe mit dem Zustand "Canceled".If none of the supplied tasks faulted but at least one of them was canceled, the returned task will end in the Canceled state.

Wenn keiner der Tasks einen Fehler verursacht hat und keine der Aufgaben abgebrochen wurde, endet die resultierende Aufgabe mit dem Zustand "RanToCompletion".If none of the tasks faulted and none of the tasks were canceled, the resulting task will end in the RanToCompletion state. Der Result der zurückgegebenen Aufgabe wird auf ein Array festgelegt, das alle Ergebnisse der angegebenen Aufgaben in derselben Reihenfolge wie die bereitgestellten Aufgaben enthält (z. b. wenn das Eingabe Aufgaben Array T1, T2, T3 enthielt), gibt die Result des Ausgabe Tasks einen TResult[] zurück, wobei arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result) ist.The Result of the returned task will be set to an array containing all of the results of the supplied tasks in the same order as they were provided (e.g. if the input tasks array contained t1, t2, t3, the output task's Result will return an TResult[] where arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result).

Wenn das angegebene Array/Enumerable keine Aufgaben enthält, wechselt die zurückgegebene Aufgabe sofort in den Zustand "RanToCompletion", bevor Sie an den Aufrufer zurückgegeben wird.If the supplied array/enumerable contains no tasks, the returned task will immediately transition to a RanToCompletion state before it's returned to the caller. Der zurückgegebene TResult[] ist ein Array von 0 Elementen.The returned TResult[] will be an array of 0 elements.

Gilt für: