Task.WaitAll 方法

定義

等候所有提供 Task 物件完成執行。

多載

WaitAll(Task[], Int32, CancellationToken)

等候所有提供 Task 物件在指定的毫秒數內完成執行,或等到等候取消為止。

WaitAll(ReadOnlySpan<Task>)

等候所有提供 Task 物件完成執行。

WaitAll(Task[])

等候所有提供 Task 物件完成執行。

WaitAll(IEnumerable<Task>, CancellationToken)

等候所有提供 Task 物件完成執行,除非取消等候。

WaitAll(Task[], Int32)

等候所有提供的 Task 物件在指定的毫秒數內完成執行。

WaitAll(Task[], CancellationToken)

等候所有提供 Task 物件完成執行,除非取消等候。

WaitAll(Task[], TimeSpan)

等候所有提供的可取消 Task 物件在指定的時間間隔內完成執行。

WaitAll(Task[], Int32, CancellationToken)

來源:
Task.cs
來源:
Task.cs
來源:
Task.cs

等候所有提供 Task 物件在指定的毫秒數內完成執行,或等到等候取消為止。

public static bool WaitAll (System.Threading.Tasks.Task[] tasks, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool WaitAll (System.Threading.Tasks.Task[] tasks, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

參數

tasks
Task[]

要等候 Task 實例的陣列。

millisecondsTimeout
Int32

等候的毫秒數,或 Infinite (-1) 無限期等候。

cancellationToken
CancellationToken

等候工作完成時要觀察的 CancellationToken

傳回

如果所有 Task 實例在分配的時間內完成執行,true;否則,false

屬性

例外狀況

已處置 tasks 中的一或多個 Task 物件。

tasks 自變數 null

至少已取消其中一個 Task 實例。 如果工作已取消,AggregateException 會在其 InnerExceptions 集合中包含 OperationCanceledException

-或-

執行至少一個 Task 實例時擲回例外狀況。

millisecondsTimeout 是 -1 以外的負數,代表無限逾時。

tasks 自變數包含 null 元素。

cancellationToken 已取消。

備註

cancellationToken 自變數可用來取消等候作業。 取消工作是一項不同的作業,而且會由上述 AggregateException 發出訊號。

適用於

.NET 9 及其他版本
產品 版本
.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.0, 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

WaitAll(ReadOnlySpan<Task>)

等候所有提供 Task 物件完成執行。

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static void WaitAll (scoped ReadOnlySpan<System.Threading.Tasks.Task> tasks);

參數

tasks
ReadOnlySpan<Task>

要等候 Task 實例的陣列。

屬性

例外狀況

tasks 自變數包含 null 專案。

至少已取消其中一個 Task 實例。

-或-

執行至少一個 Task 實例時擲回例外狀況。

適用於

.NET 9
產品 版本
.NET 9

WaitAll(Task[])

來源:
Task.cs
來源:
Task.cs
來源:
Task.cs

等候所有提供 Task 物件完成執行。

public static void WaitAll (params System.Threading.Tasks.Task[] tasks);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static void WaitAll (params System.Threading.Tasks.Task[] tasks);

參數

tasks
Task[]

要等候 Task 實例的陣列。

屬性

例外狀況

已處置 tasks 中的一或多個 Task 物件。

tasks 自變數 null

tasks 自變數包含 null 元素。

至少已取消其中一個 Task 實例。 如果工作已取消,AggregateException 例外狀況會在其 InnerExceptions 集合中包含 OperationCanceledException 例外狀況。

-或-

執行至少一個 Task 實例時擲回例外狀況。

範例

下列範例會啟動 10 個工作,每個工作都會以狀態物件的形式傳遞索引。 索引從 2 到 5 個的工作會擲回例外狀況。 呼叫 WaitAll 方法會將所有例外狀況包裝在 AggregateException 物件中,並將它傳播至呼叫線程。

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

class Example
{
    static void Main()
    {
        var tasks = new List<Task<int>>();
         
        // Define a delegate that prints and returns the system tick count
        Func<object, int> action = (object obj) =>
        {
            int i = (int)obj;

            // Make each thread sleep a different time in order to return a different tick count
            Thread.Sleep(i * 100);

            // The tasks that receive an argument between 2 and 5 throw exceptions
            if (2 <= i && i <= 5)
            {
                throw new InvalidOperationException("SIMULATED EXCEPTION");
            }

            int tickCount = Environment.TickCount;
            Console.WriteLine("Task={0}, i={1}, TickCount={2}, Thread={3}", Task.CurrentId, i, tickCount, Thread.CurrentThread.ManagedThreadId);

            return tickCount;
        };

        // Construct started tasks
        for (int i = 0; i < 10; i++)
        {
            int index = i;
            tasks.Add(Task<int>.Factory.StartNew(action, index));
        }

        try
        {
            // Wait for all the tasks to finish.
            Task.WaitAll(tasks.ToArray());

            // We should never get to this point
            Console.WriteLine("WaitAll() has not thrown exceptions. THIS WAS NOT EXPECTED.");
        }
        catch (AggregateException e)
        {
            Console.WriteLine("\nThe following exceptions have been thrown by WaitAll(): (THIS WAS EXPECTED)");
            for (int j = 0; j < e.InnerExceptions.Count; j++)
            {
                Console.WriteLine("\n-------------------------------------------------\n{0}", e.InnerExceptions[j].ToString());
            }
        }
    }
}
// The example displays output like the following:
//     Task=1, i=0, TickCount=1203822250, Thread=3
//     Task=2, i=1, TickCount=1203822359, Thread=4
//     Task=7, i=6, TickCount=1203823484, Thread=3
//     Task=8, i=7, TickCount=1203823890, Thread=4
//     Task=9, i=8, TickCount=1203824296, Thread=3
//     Task=10, i=9, TickCount=1203824796, Thread=4
//     
//     The following exceptions have been thrown by WaitAll(): (THIS WAS EXPECTED)
//     
//     -------------------------------------------------
//     System.InvalidOperationException: SIMULATED EXCEPTION
//        at Example.<Main>b__0(Object obj)
//        at System.Threading.Tasks.Task`1.InnerInvoke()
//        at System.Threading.Tasks.Task.Execute()
//     
//     -------------------------------------------------
//     System.InvalidOperationException: SIMULATED EXCEPTION
//        at Example.<Main>b__0(Object obj)
//        at System.Threading.Tasks.Task`1.InnerInvoke()
//        at System.Threading.Tasks.Task.Execute()
//     
//     -------------------------------------------------
//     System.InvalidOperationException: SIMULATED EXCEPTION
//        at Example.<Main>b__0(Object obj)
//        at System.Threading.Tasks.Task`1.InnerInvoke()
//        at System.Threading.Tasks.Task.Execute()
//     
//     -------------------------------------------------
//     System.InvalidOperationException: SIMULATED EXCEPTION
//        at Example.<Main>b__0(Object obj)
//        at System.Threading.Tasks.Task`1.InnerInvoke()
//        at System.Threading.Tasks.Task.Execute()

適用於

.NET 9 及其他版本
產品 版本
.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.0, 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

WaitAll(IEnumerable<Task>, CancellationToken)

等候所有提供 Task 物件完成執行,除非取消等候。

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static void WaitAll (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task> tasks, System.Threading.CancellationToken cancellationToken = default);

參數

tasks
IEnumerable<Task>

要等候的工作實例 IEnumerable<T>

cancellationToken
CancellationToken

等候工作完成時要觀察的 System.Threading.Tasks.Task.CancellationToken

屬性

例外狀況

tasks 自變數 null

tasks 自變數包含 null 專案。

已處置工作中一或多個 Task 物件。

cancellationToken 已取消。

至少已取消其中一個 Task 實例。 如果工作已取消,AggregateException 會在其 InnerExceptions 集合中包含 OperationCanceledException

適用於

.NET 9
產品 版本
.NET 9

WaitAll(Task[], Int32)

來源:
Task.cs
來源:
Task.cs
來源:
Task.cs

等候所有提供的 Task 物件在指定的毫秒數內完成執行。

public static bool WaitAll (System.Threading.Tasks.Task[] tasks, int millisecondsTimeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool WaitAll (System.Threading.Tasks.Task[] tasks, int millisecondsTimeout);

參數

tasks
Task[]

要等候 Task 實例的陣列。

millisecondsTimeout
Int32

等候的毫秒數,或 Infinite (-1) 無限期等候。

傳回

如果所有 Task 實例在分配的時間內完成執行,true;否則,false

屬性

例外狀況

已處置 tasks 中的一或多個 Task 物件。

tasks 自變數 null

至少已取消其中一個 Task 實例。 如果工作已取消,AggregateException 會在其 InnerExceptions 集合中包含 OperationCanceledException

-或-

執行至少一個 Task 實例時擲回例外狀況。

millisecondsTimeout 是 -1 以外的負數,代表無限逾時。

tasks 自變數包含 null 元素。

適用於

.NET 9 及其他版本
產品 版本
.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.0, 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

WaitAll(Task[], CancellationToken)

來源:
Task.cs
來源:
Task.cs
來源:
Task.cs

等候所有提供 Task 物件完成執行,除非取消等候。

public static void WaitAll (System.Threading.Tasks.Task[] tasks, System.Threading.CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static void WaitAll (System.Threading.Tasks.Task[] tasks, System.Threading.CancellationToken cancellationToken);

參數

tasks
Task[]

要等候 Task 實例的陣列。

cancellationToken
CancellationToken

等候工作完成時要觀察的 CancellationToken

屬性

例外狀況

cancellationToken 已取消。

tasks 自變數 null

至少已取消其中一個 Task 實例。 如果工作已取消,AggregateException 會在其 InnerExceptions 集合中包含 OperationCanceledException

-或-

執行至少一個 Task 實例時擲回例外狀況。

tasks 自變數包含 null 元素。

已處置 tasks 中的一或多個 Task 物件。

備註

cancellationToken 自變數可用來取消等候作業。 取消工作是不同的作業,由 AggregateException 發出訊號,如上所述。

適用於

.NET 9 及其他版本
產品 版本
.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.0, 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

WaitAll(Task[], TimeSpan)

來源:
Task.cs
來源:
Task.cs
來源:
Task.cs

等候所有提供的可取消 Task 物件在指定的時間間隔內完成執行。

public static bool WaitAll (System.Threading.Tasks.Task[] tasks, TimeSpan timeout);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static bool WaitAll (System.Threading.Tasks.Task[] tasks, TimeSpan timeout);

參數

tasks
Task[]

要等候 Task 實例的陣列。

timeout
TimeSpan

TimeSpan,表示要等候的毫秒數,或代表無限期等候 -1 毫秒的 TimeSpan

傳回

如果所有 Task 實例在分配的時間內完成執行,true;否則,false

屬性

例外狀況

已處置 tasks 中的一或多個 Task 物件。

tasks 自變數 null

至少已取消其中一個 Task 實例。 如果工作已取消,AggregateException 會在其 InnerExceptions 集合中包含 OperationCanceledException

-或-

執行至少一個 Task 實例時擲回例外狀況。

timeout 是非 -1 毫秒以外的負數,代表無限逾時。

-或-

timeout 大於 Int32.MaxValue

tasks 自變數包含 null 元素。

適用於

.NET 9 及其他版本
產品 版本
.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.0, 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