Task.WaitAll メソッド

定義

提供されたすべての Task オブジェクトの実行が完了するまで待機します。

オーバーロード

WaitAll(Task[])

指定したすべての Task オブジェクトの実行が完了するまで待機します。

WaitAll(Task[], Int32)

提供されたすべての Task オブジェクトの実行が完了するまで、指定したミリ秒数以内の間、待機します。

WaitAll(Task[], CancellationToken)

待機が取り消されない限り、指定したすべての Task オブジェクトの実行が完了するまで待機します。

WaitAll(Task[], TimeSpan)

提供されたすべてのキャンセル可能な Task オブジェクトの実行が完了するまで、指定した時間間隔の間、待機します。

WaitAll(Task[], Int32, CancellationToken)

指定したミリ秒数まで、または待機が取り消されるまで、提供されたすべての Task オブジェクトの実行が完了するのを待機します。

WaitAll(Task[])

指定したすべての Task オブジェクトの実行が完了するまで待機します。

public:
 static void WaitAll(... cli::array <System::Threading::Tasks::Task ^> ^ tasks);
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);
static member WaitAll : System.Threading.Tasks.Task[] -> unit
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member WaitAll : System.Threading.Tasks.Task[] -> unit
Public Shared Sub WaitAll (ParamArray tasks As Task())

パラメーター

tasks
Task[]

待機する Task インスタンスの配列。

属性

例外

tasksTask オブジェクトが 1 つ以上破棄されています。

tasks 引数が null です。

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

少なくとも 1 つ以上の Task インスタンスが取り消されました。 タスクが取り消された場合は、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()
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

Module WaitAllDemo
    Sub Main()
        Dim tasks As New List(Of Task(Of Integer))()
        ' Define a delegate that prints and returns the system tick count
        Dim action As Func(Of Object, Integer) = Function(obj As Object)
                                                     Dim i As Integer = CInt(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 AndAlso i <= 5 Then
                                                         Throw New InvalidOperationException("SIMULATED EXCEPTION")
                                                     End If

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

                                                     Return tickCount
                                                 End Function

        ' Construct started tasks
        For i As Integer = 0 To 9
            Dim index As Integer = i
            tasks.Add(Task(Of Integer).Factory.StartNew(action, index))
        Next

        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 e As AggregateException
            Console.WriteLine(vbLf & "The following exceptions have been thrown by WaitAll(): (THIS WAS EXPECTED)")
            For j As Integer = 0 To e.InnerExceptions.Count - 1
                Console.WriteLine(vbLf & "-------------------------------------------------" & vbLf & "{0}", e.InnerExceptions(j).ToString())
            Next
        End Try
    End Sub
End Module
' 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()

適用対象

WaitAll(Task[], Int32)

提供されたすべての Task オブジェクトの実行が完了するまで、指定したミリ秒数以内の間、待機します。

public:
 static bool WaitAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, int millisecondsTimeout);
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);
static member WaitAll : System.Threading.Tasks.Task[] * int -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member WaitAll : System.Threading.Tasks.Task[] * int -> bool
Public Shared Function WaitAll (tasks As Task(), millisecondsTimeout As Integer) As Boolean

パラメーター

tasks
Task[]

待機する Task インスタンスの配列。

millisecondsTimeout
Int32

待機するミリ秒数。無制限に待機する場合は Infinite (-1)。

戻り値

Boolean

割り当てられた時間内に true インスタンスすべての実行が完了した場合は Task。それ以外の場合は false

属性

例外

tasksTask オブジェクトが 1 つ以上破棄されています。

tasks 引数が null です。

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

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

millisecondsTimeout は無限のタイムアウトを表す -1 以外の負の数です。

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

適用対象

WaitAll(Task[], CancellationToken)

待機が取り消されない限り、指定したすべての Task オブジェクトの実行が完了するまで待機します。

public:
 static void WaitAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, System::Threading::CancellationToken cancellationToken);
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);
static member WaitAll : System.Threading.Tasks.Task[] * System.Threading.CancellationToken -> unit
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member WaitAll : System.Threading.Tasks.Task[] * System.Threading.CancellationToken -> unit
Public Shared Sub WaitAll (tasks As Task(), cancellationToken As CancellationToken)

パラメーター

tasks
Task[]

待機する Task インスタンスの配列。

cancellationToken
CancellationToken

タスクの完了を待機しているときに観察する CancellationToken

属性

例外

cancellationToken は取り消されました。

tasks 引数が null です。

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

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

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

tasksTask オブジェクトが 1 つ以上破棄されています。

注釈

引数 cancellationToken は、待機操作を取り消す場合に使用されます。 タスクの取り消しは個別の操作であり、上で説明したように AggregateException によってシグナルされます。

適用対象

WaitAll(Task[], TimeSpan)

提供されたすべてのキャンセル可能な Task オブジェクトの実行が完了するまで、指定した時間間隔の間、待機します。

public:
 static bool WaitAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, TimeSpan timeout);
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);
static member WaitAll : System.Threading.Tasks.Task[] * TimeSpan -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member WaitAll : System.Threading.Tasks.Task[] * TimeSpan -> bool
Public Shared Function WaitAll (tasks As Task(), timeout As TimeSpan) As Boolean

パラメーター

tasks
Task[]

待機する Task インスタンスの配列。

timeout
TimeSpan

待機するミリ秒数を表す TimeSpan。無制限に待機する場合は、-1 ミリ秒を表す TimeSpan

戻り値

Boolean

割り当てられた時間内に true インスタンスすべての実行が完了した場合は Task。それ以外の場合は false

属性

例外

tasksTask オブジェクトが 1 つ以上破棄されています。

tasks 引数が null です。

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

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

timeout は無限のタイムアウトを表す -1 ミリ秒以外の負の数です。 または timeoutMaxValue より大きくなっています。

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

適用対象

WaitAll(Task[], Int32, CancellationToken)

指定したミリ秒数まで、または待機が取り消されるまで、提供されたすべての Task オブジェクトの実行が完了するのを待機します。

public:
 static bool WaitAll(cli::array <System::Threading::Tasks::Task ^> ^ tasks, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);
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);
static member WaitAll : System.Threading.Tasks.Task[] * int * System.Threading.CancellationToken -> bool
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member WaitAll : System.Threading.Tasks.Task[] * int * System.Threading.CancellationToken -> bool
Public Shared Function WaitAll (tasks As Task(), millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Boolean

パラメーター

tasks
Task[]

待機する Task インスタンスの配列。

millisecondsTimeout
Int32

待機するミリ秒数。無制限に待機する場合は Infinite (-1)。

cancellationToken
CancellationToken

タスクの完了を待機しているときに観察する CancellationToken

戻り値

Boolean

割り当てられた時間内に true インスタンスすべての実行が完了した場合は Task。それ以外の場合は false

属性

例外

tasksTask オブジェクトが 1 つ以上破棄されています。

tasks 引数が null です。

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

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

millisecondsTimeout は無限のタイムアウトを表す -1 以外の負の数です。

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

cancellationToken は取り消されました。

注釈

引数 cancellationToken は、待機操作を取り消す場合に使用されます。 タスクの取り消しは個別の操作であり、上記で示したによって AggregateException シグナルされます。

適用対象