다음을 통해 공유


AggregateException.Flatten 메서드

정의

AggregateException 인스턴스를 단일한 새 인스턴스로 평면화합니다.

public:
 AggregateException ^ Flatten();
public AggregateException Flatten ();
member this.Flatten : unit -> AggregateException
Public Function Flatten () As AggregateException

반환

AggregateException

평면화된 새 AggregateException입니다.

예제

다음 예제에서는 중첩된 AggregateException 인스턴스가 하나의 루프에서 결합되고 처리됩니다.

using System;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var task1 = Task.Factory.StartNew(() => {
                     var child1 = Task.Factory.StartNew(() => {
                        var child2 = Task.Factory.StartNew(() => {
                            // This exception is nested inside three AggregateExceptions.
                            throw new CustomException("Attached child2 faulted.");
                        }, TaskCreationOptions.AttachedToParent);

                        // This exception is nested inside two AggregateExceptions.
                        throw new CustomException("Attached child1 faulted.");
                     }, TaskCreationOptions.AttachedToParent);
      });

      try {
         task1.Wait();
      }
      catch (AggregateException ae) {
         foreach (var e in ae.Flatten().InnerExceptions) {
            if (e is CustomException) {
               Console.WriteLine(e.Message);
            }
            else {
               throw;
            }
         }
      }
   }
}

public class CustomException : Exception
{
   public CustomException(String message) : base(message)
   {}
}
// The example displays the following output:
//    Attached child1 faulted.
//    Attached child2 faulted.
open System
open System.Threading.Tasks

type CustomException(message) =
    inherit Exception(message)

let task1 =
    Task.Factory.StartNew (fun () ->
        let child1 =
            Task.Factory.StartNew(
                (fun () ->
                    let child2 =
                        Task.Factory.StartNew(
                            (fun () -> raise (CustomException "Attached child2 faulted,")),
                            TaskCreationOptions.AttachedToParent
                        )
                    raise (CustomException "Attached child1 faulted.")),
                TaskCreationOptions.AttachedToParent
            )
        ()
    )

try
    task1.Wait()
with
| :? AggregateException as ae ->
    for e in ae.Flatten().InnerExceptions do
        if e :? CustomException then
            printfn "%s" e.Message
        else
            reraise()
        
// The example displays the following output:
//    Attached child1 faulted.
//    Attached child2 faulted.
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim task1 = Task.Factory.StartNew(Sub()
                                           Dim child1 = Task.Factory.StartNew(Sub()
                                                                                 Dim child2 = Task.Factory.StartNew(Sub()
                                                                                                                       Throw New CustomException("Attached child2 faulted.")
                                                                                                                    End Sub,
                                                                                                                    TaskCreationOptions.AttachedToParent)
                                                                                                                    Throw New CustomException("Attached child1 faulted.")
                                                                              End Sub,
                                                                              TaskCreationOptions.AttachedToParent)
                                        End Sub)

      Try
         task1.Wait()
      Catch ae As AggregateException
         For Each ex In ae.Flatten().InnerExceptions
            If TypeOf ex Is CustomException Then
               Console.WriteLine(ex.Message)
            Else
               Throw
            End If
         Next
      End Try
   End Sub
End Module

Class CustomException : Inherits Exception
   Public Sub New(s As String)
      MyBase.New(s)
   End Sub
End Class
' The example displays the following output:
'       Attached child1 faulted.
'       Attached child2 faulted.

또한 다음 예제가 보여주는 것처럼 AggregateException.Flatten 메서드를 사용하여 단일 AggregateException 인스턴스에서 여러 작업에 의해 throw된 여러 AggregateException 인스턴스의 내부 예외를 다시 throw할 수 있습니다.

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

public class Example2
{
   public static void Main()
   {
        try {
            ExecuteTasks();
        }
        catch (AggregateException ae) {
            foreach (var e in ae.InnerExceptions) {
                Console.WriteLine("{0}:\n   {1}", e.GetType().Name, e.Message);
            }
        }
   }

   static void ExecuteTasks()
   {
        // Assume this is a user-entered String.
        String path = @"C:\";
        List<Task> tasks = new List<Task>();

        tasks.Add(Task.Run(() => {
                             // This should throw an UnauthorizedAccessException.
                              return Directory.GetFiles(path, "*.txt",
                                                        SearchOption.AllDirectories);
                           }));

        tasks.Add(Task.Run(() => {
                              if (path == @"C:\")
                                 throw new ArgumentException("The system root is not a valid path.");
                              return new String[] { ".txt", ".dll", ".exe", ".bin", ".dat" };
                           }));

        tasks.Add(Task.Run(() => {
                               throw new NotImplementedException("This operation has not been implemented.");
                           }));

        try {
            Task.WaitAll(tasks.ToArray());
        }
        catch (AggregateException ae) {
            throw ae.Flatten();
        }
    }
}
// The example displays the following output:
//       UnauthorizedAccessException:
//          Access to the path 'C:\Documents and Settings' is denied.
//       ArgumentException:
//          The system root is not a valid path.
//       NotImplementedException:
//          This operation has not been implemented.
open System
open System.IO
open System.Threading.Tasks

let executeTasks () =
    // Assume this is a user-entered String.
    let path = @"C:\"

    let tasks =
        [| Task.Run (fun () ->
               // This should throw an UnauthorizedAccessException.
               Directory.GetFiles(path, "*.txt", SearchOption.AllDirectories))
           :> Task
           Task.Run (fun () ->
               if path = @"C:\" then
                   raise (ArgumentException "The system root is not a valid path.")

               [| ".txt"; ".dll"; ".exe"; ".bin"; ".dat" |])
           :> Task
           Task.Run(fun () -> raise (NotImplementedException "This operation has not been implemented")) |]

    try
        Task.WaitAll(tasks)
    with
    | :? AggregateException as ae -> raise (ae.Flatten())

try
    executeTasks ()
with 
| :? AggregateException as ae ->
    for e in ae.InnerExceptions do
        printfn $"{e.GetType().Name}:\n   {e.Message}"

// The example displays the following output:
//       UnauthorizedAccessException:
//          Access to the path 'C:\Documents and Settings' is denied.
//       ArgumentException:
//          The system root is not a valid path.
//       NotImplementedException:
//          This operation has not been implemented.
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks

Module Example
    Public Sub Main()
       Try
          ExecuteTasks()
       Catch ae As AggregateException
          For Each e In ae.InnerExceptions
             Console.WriteLine("{0}:{2}   {1}", e.GetType().Name, e.Message,
                               vbCrLf)
          Next
       End Try
    End Sub

    Sub ExecuteTasks()
        ' Assume this is a user-entered String.
        Dim path = "C:\"
        Dim tasks As New List(Of Task)
        
        tasks.Add(Task.Run(Function()
                             ' This should throw an UnauthorizedAccessException.
                              Return Directory.GetFiles(path, "*.txt",
                                                        SearchOption.AllDirectories)
                           End Function))

        tasks.Add(Task.Run(Function()
                              If path = "C:\" Then
                                 Throw New ArgumentException("The system root is not a valid path.")
                              End If
                              Return { ".txt", ".dll", ".exe", ".bin", ".dat" }
                           End Function))

        tasks.Add(Task.Run(Sub()
                              Throw New NotImplementedException("This operation has not been implemented.")
                           End Sub))

        Try
            Task.WaitAll(tasks.ToArray)
        Catch ae As AggregateException
            Throw ae.Flatten()
        End Try
    End Sub
End Module
' The example displays the following output:
'       UnauthorizedAccessException:
'          Access to the path 'C:\Documents and Settings' is denied.
'       ArgumentException:
'          The system root is not a valid path.
'       NotImplementedException:
'          This operation has not been implemented.

설명

태스크에 예외를 throw하는 연결된 자식 태스크가 있는 경우 해당 예외는 부모 태스크로 AggregateException 전파되기 전에 예외로 래핑됩니다. 이 예외는 해당 예외를 호출 스레드로 다시 전파하기 전에 자체 AggregateException 예외로 래핑합니다. 이러한 경우 InnerExceptions , WaitTask.WaitAny 또는 Task.WaitAll 메서드에 의해 Task.Waitcatch된 예외의 AggregateException 속성에는 오류를 발생시킨 원래 예외가 아닌 하나 이상의 AggregateException 인스턴스가 포함됩니다. 중첩된 AggregateException 예외를 반복하지 않도록 하려면 메서드를 사용하여 Flatten 반환 AggregateException 된 개체의 속성에 원래 예외가 InnerExceptions 포함되도록 중첩된 AggregateException 예외를 모두 제거할 수 있습니다.

이 메서드는 현재 AggregateException 인스턴스의 내부 예외인 예외의 AggregateException 모든 인스턴스를 재귀적으로 평면화합니다. 새 AggregateException 인스턴스에서 반환되는 내부 예외는 현재 AggregateException 인스턴스에 루팅된 예외 트리의 모든 내부 예외의 공용 구조체입니다.

적용 대상

추가 정보