Task.WhenAll Metoda

Definicja

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

Przeciążenia

WhenAll(IEnumerable<Task>)

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task w kolekcji wyliczalnej.

WhenAll(ReadOnlySpan<Task>)

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

WhenAll(Task[])

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task w tablicy.

WhenAll<TResult>(ReadOnlySpan<Task<TResult>>)

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

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

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task<TResult> w kolekcji wyliczalnej.

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

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task<TResult> w tablicy.

WhenAll(IEnumerable<Task>)

Źródło:
Task.cs
Źródło:
Task.cs
Źródło:
Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task w kolekcji wyliczalnej.

public static System.Threading.Tasks.Task WhenAll (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task> tasks);

Parametry

tasks
IEnumerable<Task>

Zadania do oczekiwania na ukończenie.

Zwraca

Zadanie reprezentujące ukończenie wszystkich dostarczonych zadań.

Wyjątki

Argument tasks został null.

Kolekcja tasks zawierała zadanie null.

Przykłady

Poniższy przykład tworzy zestaw zadań, które wysyłają polecenia ping do adresów URL w tablicy. Zadania są przechowywane w kolekcji List<Task> przekazywanej do metody WhenAll(IEnumerable<Task>). Po wywołaniu metody Wait gwarantuje, że wszystkie wątki zostały ukończone, przykład analizuje właściwość Task.Status w celu ustalenia, czy jakiekolwiek zadania zostały uszkodzone.

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

Uwagi

Przeciążenia metody WhenAll zwracającej obiekt Task są zwykle wywoływane, gdy interesuje Cię stan zestawu zadań lub wyjątków zgłaszanych przez zestaw zadań.

Uwaga

Wywołanie metody WhenAll(IEnumerable<Task>) nie blokuje wątku wywołującego.

Jeśli którekolwiek z podanych zadań zostanie ukończone w stanie uszkodzonym, zwrócone zadanie zostanie również ukończone w stanie Faulted, gdzie jego wyjątki będą zawierać agregację zestawu nieprzypisanych wyjątków od każdego z dostarczonych zadań.

Jeśli żadne z podanych zadań nie zostało uszkodzone, ale co najmniej jedno z nich zostało anulowane, zwrócone zadanie zakończy się w stanie Canceled.

Jeśli żadne z zadań nie zostało uszkodzone i żadne z zadań nie zostały anulowane, wynikowe zadanie zakończy się w stanie RanToCompletion.

Jeśli podana tablica/wyliczenie nie zawiera żadnych zadań, zwrócone zadanie natychmiast przejdzie do stanu RanToCompletion przed zwróceniem do obiektu wywołującego.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

WhenAll(ReadOnlySpan<Task>)

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

public static System.Threading.Tasks.Task WhenAll (scoped ReadOnlySpan<System.Threading.Tasks.Task> tasks);

Parametry

tasks
ReadOnlySpan<Task>

Zadania do oczekiwania na ukończenie.

Zwraca

Zadanie reprezentujące ukończenie wszystkich dostarczonych zadań.

Wyjątki

Tablica tasks zawiera zadanie null.

Uwagi

Jeśli którekolwiek z podanych zadań zostanie ukończone w stanie uszkodzonym, zwrócone zadanie zostanie również ukończone w stanie Uszkodzony, gdzie jego wyjątki będą zawierać agregację zestawu nieprzypisanych wyjątków od każdego z dostarczonych zadań.

Jeśli żadne z podanych zadań nie zostało uszkodzone, ale co najmniej jedno z nich zostało anulowane, zwrócone zadanie zakończy się w stanie Anulowane.

Jeśli żadne z zadań nie zostało uszkodzone i żadne z zadań nie zostały anulowane, wynikowe zadanie zakończy się w stanie RanToCompletion.

Jeśli podany zakres nie zawiera żadnych zadań, zwrócone zadanie natychmiast przejdzie do stanu RanToCompletion, zanim zostanie zwrócone do elementu wywołującego.

Dotyczy

.NET 9
Produkt Wersje
.NET 9

WhenAll(Task[])

Źródło:
Task.cs
Źródło:
Task.cs
Źródło:
Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task w tablicy.

public static System.Threading.Tasks.Task WhenAll (params System.Threading.Tasks.Task[] tasks);

Parametry

tasks
Task[]

Zadania do oczekiwania na ukończenie.

Zwraca

Zadanie reprezentujące ukończenie wszystkich dostarczonych zadań.

Wyjątki

Argument tasks został null.

Tablica tasks zawierała zadanie null.

Przykłady

Poniższy przykład tworzy zestaw zadań, które wysyłają polecenia ping do adresów URL w tablicy. Zadania są przechowywane w kolekcji List<Task>, która jest konwertowana na tablicę i przekazywana do metody WhenAll(IEnumerable<Task>). Po wywołaniu metody Wait gwarantuje, że wszystkie wątki zostały ukończone, przykład analizuje właściwość Task.Status w celu ustalenia, czy jakiekolwiek zadania zostały uszkodzone.

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

Uwagi

Przeciążenia metody WhenAll zwracającej obiekt Task są zwykle wywoływane, gdy interesuje Cię stan zestawu zadań lub wyjątków zgłaszanych przez zestaw zadań.

Uwaga

Wywołanie metody WhenAll(Task[]) nie blokuje wątku wywołującego.

Jeśli którekolwiek z podanych zadań zostanie ukończone w stanie uszkodzonym, zwrócone zadanie zostanie również ukończone w stanie Faulted, gdzie jego wyjątki będą zawierać agregację zestawu nieprzypisanych wyjątków od każdego z dostarczonych zadań.

Jeśli żadne z podanych zadań nie zostało uszkodzone, ale co najmniej jedno z nich zostało anulowane, zwrócone zadanie zakończy się w stanie Canceled.

Jeśli żadne z zadań nie zostało uszkodzone i żadne z zadań nie zostały anulowane, wynikowe zadanie zakończy się w stanie RanToCompletion.

Jeśli podana tablica/wyliczenie nie zawiera żadnych zadań, zwrócone zadanie natychmiast przejdzie do stanu RanToCompletion przed zwróceniem do obiektu wywołującego.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

WhenAll<TResult>(ReadOnlySpan<Task<TResult>>)

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

public static System.Threading.Tasks.Task<TResult[]> WhenAll<TResult> (scoped ReadOnlySpan<System.Threading.Tasks.Task<TResult>> tasks);

Parametry typu

TResult

Parametry

tasks
ReadOnlySpan<Task<TResult>>

Zadania do oczekiwania na ukończenie.

Zwraca

Task<TResult[]>

Zadanie reprezentujące ukończenie wszystkich dostarczonych zadań.

Wyjątki

Tablica tasks zawiera zadanie null.

Uwagi

Jeśli którekolwiek z podanych zadań zostanie ukończone w stanie uszkodzonym, zwrócone zadanie zostanie również ukończone w stanie Uszkodzony, gdzie jego wyjątki będą zawierać agregację zestawu nieprzypisanych wyjątków od każdego z dostarczonych zadań.

Jeśli żadne z podanych zadań nie zostało uszkodzone, ale co najmniej jedno z nich zostało anulowane, zwrócone zadanie zakończy się w stanie Anulowane.

Jeśli żadne z zadań nie zostało uszkodzone i żadne z zadań nie zostały anulowane, wynikowe zadanie zakończy się w stanie RanToCompletion. Wynik zwróconego zadania zostanie ustawiony na tablicę zawierającą wszystkie wyniki dostarczonych zadań w takiej samej kolejności, jak zostały podane (np. jeśli tablica zadań wejściowych zawiera t1, t2, t3, wynik zadania wyjściowego zwróci wynik TResult[] gdzie arr[0] == t1. Wynik, arr[1] == t2. Wynik i arr[2] == t3. Wynik).

Jeśli podana tablica/wyliczenie nie zawiera żadnych zadań, zwrócone zadanie natychmiast przejdzie do stanu RanToCompletion przed zwróceniem do obiektu wywołującego. Zwrócony element TResult[] będzie tablicą z 0 elementami.

Dotyczy

.NET 9
Produkt Wersje
.NET 9

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

Źródło:
Task.cs
Źródło:
Task.cs
Źródło:
Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task<TResult> w kolekcji wyliczalnej.

public static System.Threading.Tasks.Task<TResult[]> WhenAll<TResult> (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task<TResult>> tasks);

Parametry typu

TResult

Typ ukończonego zadania.

Parametry

tasks
IEnumerable<Task<TResult>>

Zadania do oczekiwania na ukończenie.

Zwraca

Task<TResult[]>

Zadanie reprezentujące ukończenie wszystkich dostarczonych zadań.

Wyjątki

Argument tasks został null.

Kolekcja tasks zawierała zadanie null.

Przykłady

Poniższy przykład tworzy dziesięć zadań, z których każdy tworzy wystąpienie generatora liczb losowych, który tworzy 1000 losowych liczb z zakresu od 1 do 1000 i oblicza ich średnią. Metoda Delay(Int32) służy do opóźniania tworzenia wystąpień generatorów liczb losowych, aby nie były tworzone przy użyciu identycznych wartości inicjujących. Wywołanie metody WhenAll zwraca następnie tablicę Int64 zawierającą średnią obliczoną przez każde zadanie. Są one następnie używane do obliczenia ogólnej średniej.

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

W tym przypadku dziesięć pojedynczych zadań jest przechowywanych w obiekcie List<T>. List<T> implementuje interfejs IEnumerable<T>.

Uwagi

Wywołanie metody WhenAll<TResult>(IEnumerable<Task<TResult>>) nie blokuje wątku wywołującego. Jednak wywołanie zwróconej właściwości Result blokuje wątek wywołujący.

Jeśli którekolwiek z podanych zadań zostanie ukończone w stanie uszkodzonym, zwrócone zadanie zostanie również ukończone w stanie Faulted, gdzie jego wyjątki będą zawierać agregację zestawu nieprzypisanych wyjątków od każdego z dostarczonych zadań.

Jeśli żadne z podanych zadań nie zostało uszkodzone, ale co najmniej jedno z nich zostało anulowane, zwrócone zadanie zakończy się w stanie Canceled.

Jeśli żadne z zadań nie zostało uszkodzone i żadne z zadań nie zostały anulowane, wynikowe zadanie zakończy się w stanie RanToCompletion. Właściwość Task<TResult>.Result zwróconego zadania zostanie ustawiona na tablicę zawierającą wszystkie wyniki dostarczonych zadań w takiej samej kolejności, jak zostały podane (np. jeśli tablica zadań wejściowych zawiera t1, t2, t3, właściwość Task<TResult>.Result zadania wyjściowego zwróci TResult[], w której arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result).

Jeśli argument tasks nie zawiera żadnych zadań, zwrócone zadanie natychmiast przejdzie do stanu RanToCompletion, zanim zostanie zwrócony do elementu wywołującego. Zwrócona TResult[] będzie tablicą 0 elementów.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Źródło:
Task.cs
Źródło:
Task.cs
Źródło:
Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task<TResult> w tablicy.

public static System.Threading.Tasks.Task<TResult[]> WhenAll<TResult> (params System.Threading.Tasks.Task<TResult>[] tasks);

Parametry typu

TResult

Typ ukończonego zadania.

Parametry

tasks
Task<TResult>[]

Zadania do oczekiwania na ukończenie.

Zwraca

Task<TResult[]>

Zadanie reprezentujące ukończenie wszystkich dostarczonych zadań.

Wyjątki

Argument tasks został null.

Tablica tasks zawierała zadanie null.

Przykłady

Poniższy przykład tworzy dziesięć zadań, z których każdy tworzy wystąpienie generatora liczb losowych, który tworzy 1000 losowych liczb z zakresu od 1 do 1000 i oblicza ich średnią. W tym przypadku dziesięć pojedynczych zadań jest przechowywanych w tablicy Task<Int64>. Metoda Delay(Int32) służy do opóźniania tworzenia wystąpień generatorów liczb losowych, aby nie były tworzone przy użyciu identycznych wartości inicjujących. Wywołanie metody WhenAll zwraca następnie tablicę Int64 zawierającą średnią obliczoną przez każde zadanie. Są one następnie używane do obliczenia ogólnej średniej.

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

Uwagi

Wywołanie metody WhenAll<TResult>(Task<TResult>[]) nie blokuje wątku wywołującego. Jednak wywołanie zwróconej właściwości Result blokuje wątek wywołujący.

Jeśli którekolwiek z podanych zadań zostanie ukończone w stanie uszkodzonym, zwrócone zadanie zostanie również ukończone w stanie Faulted, gdzie jego wyjątki będą zawierać agregację zestawu nieprzypisanych wyjątków od każdego z dostarczonych zadań.

Jeśli żadne z podanych zadań nie zostało uszkodzone, ale co najmniej jedno z nich zostało anulowane, zwrócone zadanie zakończy się w stanie Canceled.

Jeśli żadne z zadań nie zostało uszkodzone i żadne z zadań nie zostały anulowane, wynikowe zadanie zakończy się w stanie RanToCompletion. Result zwróconego zadania zostanie ustawiona na tablicę zawierającą wszystkie wyniki dostarczonych zadań w tej samej kolejności, w której zostały podane (np. jeśli tablica zadań wejściowych zawiera t1, t2, t3, Result zadania wyjściowego zwróci TResult[] gdzie arr[0] == t1.Result, arr[1] == t2.Result, and arr[2] == t3.Result).

Jeśli podana tablica/wyliczenie nie zawiera żadnych zadań, zwrócone zadanie natychmiast przejdzie do stanu RanToCompletion przed zwróceniem do obiektu wywołującego. Zwrócona TResult[] będzie tablicą 0 elementów.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0