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)

Source:
Task.cs
Source:
Task.cs
Source:
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 인스턴스 중 하나 이상이 취소되었습니다. 작업이 취소된 경우 AggregateExceptionInnerExceptions 컬렉션에 OperationCanceledException 포함합니다.

-또는-

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 throw되었습니다.

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 인스턴스 중 하나 이상을 실행하는 동안 예외가 throw되었습니다.

적용 대상

.NET 9
제품 버전
.NET 9

WaitAll(Task[])

Source:
Task.cs
Source:
Task.cs
Source:
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 인스턴스 중 하나 이상을 실행하는 동안 예외가 throw되었습니다.

예제

다음 예제에서는 각각 인덱스를 상태 개체로 전달하는 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()

적용 대상

.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 인스턴스 중 하나 이상이 취소되었습니다. 작업이 취소된 경우 AggregateExceptionInnerExceptions 컬렉션에 OperationCanceledException 포함합니다.

적용 대상

.NET 9
제품 버전
.NET 9

WaitAll(Task[], Int32)

Source:
Task.cs
Source:
Task.cs
Source:
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 인스턴스 중 하나 이상이 취소되었습니다. 작업이 취소된 경우 AggregateExceptionInnerExceptions 컬렉션에 OperationCanceledException 포함합니다.

-또는-

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 throw되었습니다.

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)

Source:
Task.cs
Source:
Task.cs
Source:
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 인스턴스 중 하나 이상이 취소되었습니다. 작업이 취소된 경우 AggregateExceptionInnerExceptions 컬렉션에 OperationCanceledException 포함합니다.

-또는-

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 throw되었습니다.

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)

Source:
Task.cs
Source:
Task.cs
Source:
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 인스턴스 중 하나 이상이 취소되었습니다. 작업이 취소된 경우 AggregateExceptionInnerExceptions 컬렉션에 OperationCanceledException 포함합니다.

-또는-

Task 인스턴스 중 하나 이상을 실행하는 동안 예외가 throw되었습니다.

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