Task.WaitAll 메서드

참조

정의

네임스페이스:: System.Threading.Tasks

어셈블리:: System.Threading.Tasks.dll

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

제공된 모든 Task 개체의 실행이 완료되기를 기다립니다.

오버로드

WaitAll(Task[], Int32, CancellationToken)	제공된 모든 Task 개체가 지정된 시간(밀리초) 내에 실행을 완료하기를 기다리거나 대기가 취소될 때까지 기다립니다.
WaitAll(Task[], TimeSpan)	모든 제공된 취소 가능한 Task 개체가 지정된 시간 간격 내에 실행을 완료할 때까지 기다립니다.
WaitAll(Task[], CancellationToken)	대기가 취소되지 않는 경우 제공된 모든 Task 개체가 실행을 완료하기를 기다립니다.
WaitAll(Task[])	제공된 모든 Task 개체의 실행이 완료되기를 기다립니다.
WaitAll(Task[], Int32)	모든 제공된 Task 개체가 지정된 시간(밀리초) 내에 실행을 완료할 때까지 기다립니다.

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입니다.

특성: UnsupportedOSPlatformAttribute

예외

ObjectDisposedException

tasks에서 하나 이상의 Task 개체가 삭제되었습니다.

ArgumentNullException

tasks 인수가 null인 경우

AggregateException

Task 인스턴스 중 하나 이상이 취소된 경우 작업이 취소된 경우 AggregateException의 InnerExceptions 컬렉션에 OperationCanceledException이 포함됩니다.

또는

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 발생한 경우

ArgumentOutOfRangeException

millisecondsTimeout이 시간 제한 없음을 나타내는 -1 이외의 음수인 경우

ArgumentException

tasks 인수에 null 요소가 포함되어 있습니다.

OperationCanceledException

cancellationToken을 취소했습니다.

설명

인수는 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입니다.

특성: UnsupportedOSPlatformAttribute

예외

ObjectDisposedException

tasks에서 하나 이상의 Task 개체가 삭제되었습니다.

ArgumentNullException

tasks 인수가 null인 경우

AggregateException

Task 인스턴스 중 하나 이상이 취소된 경우 작업이 취소된 경우 AggregateException의 InnerExceptions 컬렉션에 OperationCanceledException이 포함됩니다.

또는

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 발생한 경우

ArgumentOutOfRangeException

timeout은 시간 제한이 없음을 나타내는 -1밀리초 이외의 음수입니다.

또는

timeout 가 Int32.MaxValue보다 큽다.

ArgumentException

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입니다.

특성: UnsupportedOSPlatformAttribute

예외

OperationCanceledException

cancellationToken을 취소했습니다.

ArgumentNullException

tasks 인수가 null인 경우

AggregateException

Task 인스턴스 중 하나 이상이 취소된 경우 작업이 취소된 경우 AggregateException의 InnerExceptions 컬렉션에 OperationCanceledException이 포함됩니다.

또는

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 발생한 경우

ArgumentException

tasks 인수에 null 요소가 포함되어 있습니다.

ObjectDisposedException

tasks에서 하나 이상의 Task 개체가 삭제되었습니다.

설명

인수는 cancellationToken 대기 작업을 취소하는 데 사용됩니다. 작업의 취소는 고유한 작업이며 위에서 설명한 대로 에 AggregateException 의해 신호를 받습니다.

적용 대상

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 인스턴스의 배열입니다.

특성: UnsupportedOSPlatformAttribute

예외

ObjectDisposedException

tasks에서 하나 이상의 Task 개체가 삭제되었습니다.

ArgumentNullException

tasks 인수가 null인 경우

ArgumentException

tasks 인수에 null 요소가 포함되어 있습니다.

AggregateException

Task 인스턴스 중 하나 이상이 취소된 경우 작업이 취소된 경우 AggregateException 예외에는 해당 InnerExceptions 컬렉션의 OperationCanceledException 예외가 포함됩니다.

또는

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 발생한 경우

예제

다음 예제에서는 각각 인덱스를 상태 개체로 전달하는 10개의 작업을 시작합니다. 인덱스가 2~5개인 태스크는 예외를 throw합니다. 메서드에 대한 호출은 개체의 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()

open System
open System.Threading
open System.Threading.Tasks

// Define a delegate that prints and returns the system tick count
let action =
    fun (obj: obj) ->
        let i = obj :?> int

        // 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 then
            raise (InvalidOperationException "SIMULATED EXCEPTION")


        let tickCount = Environment.TickCount
        printfn $"Task={Task.CurrentId}, i={i}, TickCount={tickCount}, Thread={Thread.CurrentThread.ManagedThreadId}"
        tickCount

// Construct started tasks
let tasks =
    [| for i = 0 to 9 do
           Task<int>.Factory.StartNew (action, i) |]

try

    // Wait for all the tasks to finish.
    Seq.cast tasks |> Seq.toArray |> Task.WaitAll

    // We should never get to this point
    printfn "WaitAll() has not thrown exceptions. THIS WAS NOT EXPECTED."

with :? AggregateException as e ->
    printfn "\nThe following exceptions have been thrown by WaitAll(): (THIS WAS EXPECTED)"

    for ex in e.InnerExceptions do
        printfn $"\n-------------------------------------------------\n{ex}"

// 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입니다.

특성: UnsupportedOSPlatformAttribute

예외

ObjectDisposedException

tasks에서 하나 이상의 Task 개체가 삭제되었습니다.

ArgumentNullException

tasks 인수가 null인 경우

AggregateException

Task 인스턴스 중 하나 이상이 취소된 경우 작업이 취소된 경우 AggregateException의 InnerExceptions 컬렉션에 OperationCanceledException이 포함됩니다.

또는

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 발생한 경우

ArgumentOutOfRangeException

millisecondsTimeout이 시간 제한 없음을 나타내는 -1 이외의 음수인 경우

ArgumentException

tasks 인수에 null 요소가 포함되어 있습니다.

적용 대상

Task.WaitAll 메서드

정의

오버로드

WaitAll(Task[], Int32, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

WaitAll(Task[], TimeSpan)

매개 변수

반환

예외

적용 대상

WaitAll(Task[], CancellationToken)

매개 변수

예외

설명

적용 대상

WaitAll(Task[])

매개 변수

예외

예제

적용 대상

WaitAll(Task[], Int32)

매개 변수

반환

예외

적용 대상

피드백

피드백

추가 리소스