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 内の 1 つ以上の Task オブジェクトが破棄されました。

tasks 引数は nullです。

Task インスタンスの少なくとも 1 つが取り消されました。 タスクが取り消された場合、AggregateException には InnerExceptions コレクション内の OperationCanceledException が含まれます。

-又は-

少なくとも 1 つの 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 インスタンスの少なくとも 1 つが取り消されました。

-又は-

少なくとも 1 つの 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 内の 1 つ以上の Task オブジェクトが破棄されました。

tasks 引数は nullです。

tasks 引数に null 要素が含まれています。

Task インスタンスの少なくとも 1 つが取り消されました。 タスクが取り消された場合、AggregateException 例外には InnerExceptions コレクションに OperationCanceledException 例外が含まれます。

-又は-

少なくとも 1 つの 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 要素が含まれています。

タスク内の 1 つ以上の Task オブジェクトが破棄されました。

cancellationToken が取り消されました。

Task インスタンスの少なくとも 1 つが取り消されました。 タスクが取り消された場合、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 内の 1 つ以上の Task オブジェクトが破棄されました。

tasks 引数は nullです。

Task インスタンスの少なくとも 1 つが取り消されました。 タスクが取り消された場合、AggregateException には InnerExceptions コレクション内の OperationCanceledException が含まれます。

-又は-

少なくとも 1 つの 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 インスタンスの少なくとも 1 つが取り消されました。 タスクが取り消された場合、AggregateException には InnerExceptions コレクション内の OperationCanceledException が含まれます。

-又は-

少なくとも 1 つの Task インスタンスの実行中に例外がスローされました。

tasks 引数に null 要素が含まれています。

tasks 内の 1 つ以上の 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 内の 1 つ以上の Task オブジェクトが破棄されました。

tasks 引数は nullです。

Task インスタンスの少なくとも 1 つが取り消されました。 タスクが取り消された場合、AggregateException には InnerExceptions コレクション内の OperationCanceledException が含まれます。

-又は-

少なくとも 1 つの Task インスタンスの実行中に例外がスローされました。

timeout は、無限タイムアウトを表す、-1 ミリ秒以外の負の数です。

-又は-

が 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