AggregateException Kelas

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

AggregateException.cs

Mewakili satu atau beberapa kesalahan yang terjadi selama eksekusi aplikasi.

public ref class AggregateException : Exception

public class AggregateException : Exception

type AggregateException = class
    inherit Exception

Public Class AggregateException
Inherits Exception

Warisan

Object

Exception

AggregateException

Contoh

Contoh berikut menangkap AggregateException pengecualian dan memanggil Handle metode untuk menangani setiap pengecualian yang dikandungnya. Mengkompilasi dan menjalankan contoh dengan variabel pertama task1 harus menghasilkan AggregateException objek yang berisi UnauthorizedAccessException pengecualian. Mengomentari baris itu, membatalkan komentar variabel kedua task1 , dan mengkompilasi dan menjalankan contoh menghasilkan AggregateException objek yang berisi IndexOutOfRangeException pengecualian.

using System;
using System.IO;
using System.Threading.Tasks;

class Example
{
   static async Task Main(string[] args)
   {
      // Get a folder path whose directories should throw an UnauthorizedAccessException.
      string path = Directory.GetParent(
                              Environment.GetFolderPath(
                              Environment.SpecialFolder.UserProfile)).FullName;

      // Use this line to throw UnauthorizedAccessException, which we handle.
      Task<string[]> task1 = Task<string[]>.Factory.StartNew(() => GetAllFiles(path));

      // Use this line to throw an exception that is not handled.
      // Task task1 = Task.Factory.StartNew(() => { throw new IndexOutOfRangeException(); } );
      try
      {
          await task1;
      }
      catch (UnauthorizedAccessException ae)
      {
          Console.WriteLine("Caught unauthorized access exception-await behavior");
      }
      catch (AggregateException ae)
      {
          Console.WriteLine("Caught aggregate exception-Task.Wait behavior");
          ae.Handle((x) =>
          {
              if (x is UnauthorizedAccessException) // This we know how to handle.
              {
                  Console.WriteLine("You do not have permission to access all folders in this path.");
                  Console.WriteLine("See your network administrator or try another path.");
                  return true;
              }
              return false; // Let anything else stop the application.
          });
      }

      Console.WriteLine("task1 Status: {0}{1}", task1.IsCompleted ? "Completed," : "",
                                                task1.Status);
   }

   static string[] GetAllFiles(string str)
   {
      // Should throw an UnauthorizedAccessException exception.
      return System.IO.Directory.GetFiles(str, "*.txt", System.IO.SearchOption.AllDirectories);
   }
}
// The example displays the following output if the file access task is run:
//       You do not have permission to access all folders in this path.
//       See your network administrator or try another path.
//       task1 Status: Completed,Faulted
// It displays the following output if the second task is run:
//       Unhandled Exception: System.AggregateException: One or more errors occurred. ---
//       > System.IndexOutOfRangeException: Index was outside the bounds of the array.
//          at Example.<Main>b__0()
//          at System.Threading.Tasks.Task.Execute()
//          --- End of inner exception stack trace ---
//          at System.AggregateException.Handle(Func`2 predicate)
//          at Example.Main(String[] args)

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

let getAllFiles str =
    // Should throw an UnauthorizedAccessException exception.
    System.IO.Directory.GetFiles(str, "*.txt", System.IO.SearchOption.AllDirectories)

// Get a folder path whose directories should throw an UnauthorizedAccessException.
let path =
    let directory =
        Environment.SpecialFolder.UserProfile
        |> Environment.GetFolderPath
        |> Directory.GetParent
    directory.FullName

// Use this line to throw an exception that is not handled.
// let task1 = Task<string []>.Factory.StartNew(fun () -> raise (IndexOutOfRangeException()) )
let task1 = Task.Factory.StartNew(fun () -> getAllFiles (path))

let execute () =
    try
        task1.Wait()
    with
    | :? UnauthorizedAccessException -> printfn "Caught unauthorized access exception-await behavior"
    | :? AggregateException as ae ->
        printfn "Caught aggregate exception-Task.Wait behavior"

        ae.Handle (fun x ->
            match x with
            | :? UnauthorizedAccessException ->
                printfn "You do not have permission to access all folders in this path."
                printfn "See your network administrator or try another path."
                true
            | _ -> false)
    printfn $"""task1 Status: {if task1.IsCompleted then "Completed," else ""}{task1.Status}"""

execute ()

// The example displays the following output if the file access task is run:
//       You do not have permission to access all folders in this path.
//       See your network administrator or try another path.
//       task1 Status: Completed,Faulted
// It displays the following output if the second task is run:
//       Unhandled exception. System.AggregateException: One or more errors occurred. (Index was outside the bounds of the array.) (Index was outside the bounds of the array.)
//        ---> System.IndexOutOfRangeException: Index was outside the bounds of the array.
//          at Exception1.task1@19.Invoke()
//          at System.Threading.Tasks.Task`1.InnerInvoke()
//          at System.Threading.Tasks.Task.<>c.<.cctor>b__277_0(Object obj)
//          at System.Threading.ExecutionContext.RunFromThreadPoolDispatchLoop(Thread threadPoolThread, ExecutionContext executionContext, ContextCallback callback, Object state)   
//       --- End of stack trace from previous location ---
//          at System.Threading.ExecutionContext.RunFromThreadPoolDispatchLoop(Thread threadPoolThread, ExecutionContext executionContext, ContextCallback callback, Object state)   
//          at System.Threading.Tasks.Task.ExecuteWithThreadLocal(Task& currentTaskSlot, Thread threadPoolThread)
//          --- End of inner exception stack trace ---
//          at System.AggregateException.Handle(Func`2 predicate)
//          at <StartupCode$exception1>.$Exception1.main@()

Imports System.IO
Imports System.Threading.Tasks

Module Example
    Sub Main()
        ' Get a folder path whose directories should throw an UnauthorizedAccessException.
        Dim path As String = Directory.GetParent(
                                       Environment.GetFolderPath(
                                       Environment.SpecialFolder.UserProfile)).FullName

        ' Use this line to throw UnauthorizedAccessException, which we handle.
        Dim task1 = Task(Of String()).Factory.StartNew(Function() GetAllFiles(path))

        ' Use this line to throw an exception that is not handled.
        ' Task task1 = Task.Factory.StartNew(Sub() Throw New IndexOutOfRangeException() )
        Try
            task1.Wait()
        Catch ae As AggregateException
            ae.Handle(Function(x)
                          If TypeOf (x) Is UnauthorizedAccessException Then ' This we know how to handle
                              Console.WriteLine("You do not have permission to access all folders in this path.")
                              Console.WriteLine("See your network administrator or try another path.")
                              Return True
                          Else
                              Return False ' Let anything else stop the application.
                          End If
                      End Function)
        End Try

      Console.WriteLine("task1 Status: {0}{1}", If(task1.IsCompleted, "Completed,", ""), 
                                                task1.Status)
    End Sub

    Function GetAllFiles(ByVal str As String) As String()
        ' Should throw an UnauthorizedAccessException exception. 
        Return System.IO.Directory.GetFiles(str, "*.txt", System.IO.SearchOption.AllDirectories)
    End Function
End Module

Keterangan

AggregateException digunakan untuk mengonsolidasikan beberapa kegagalan ke dalam satu objek pengecualian yang dapat dilemparkan. Ini digunakan secara ekstensif di Pustaka Paralel Tugas (TPL) dan Parallel LINQ (PLINQ). Untuk informasi selengkapnya, lihat Penanganan Pengecualian dan Cara: Menangani Pengecualian dalam Kueri PLINQ. Untuk informasi tambahan, lihat entri Agregat Pengecualian di blog .NET Matters.

Konstruktor

AggregateException()	Menginisialisasi instans AggregateException baru kelas dengan pesan yang disediakan sistem yang menjelaskan kesalahan.
AggregateException(Exception[])	Menginisialisasi instans AggregateException baru kelas dengan referensi ke pengecualian dalam yang merupakan penyebab pengecualian ini.
AggregateException(IEnumerable<Exception>)	Menginisialisasi instans AggregateException baru kelas dengan referensi ke pengecualian dalam yang merupakan penyebab pengecualian ini.
AggregateException(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans AggregateException baru kelas dengan data berseri.
AggregateException(String)	Menginisialisasi instans AggregateException baru kelas dengan pesan tertentu yang menjelaskan kesalahan.
AggregateException(String, Exception)	Menginisialisasi instans AggregateException baru kelas dengan pesan kesalahan yang ditentukan dan referensi ke pengecualian dalam yang merupakan penyebab pengecualian ini.
AggregateException(String, Exception[])	Menginisialisasi instans AggregateException baru kelas dengan pesan kesalahan yang ditentukan dan mereferensikan ke pengecualian dalam yang merupakan penyebab pengecualian ini.
AggregateException(String, IEnumerable<Exception>)	Menginisialisasi instans AggregateException baru kelas dengan pesan kesalahan yang ditentukan dan mereferensikan ke pengecualian dalam yang merupakan penyebab pengecualian ini.

Properti

Data	Mendapatkan kumpulan pasangan kunci/nilai yang memberikan informasi tambahan yang ditentukan pengguna tentang pengecualian. (Diperoleh dari Exception)
HelpLink	Mendapatkan atau mengatur tautan ke file bantuan yang terkait dengan pengecualian ini. (Diperoleh dari Exception)
HResult	Mendapatkan atau menetapkan HRESULT, nilai numerik berkode yang ditetapkan ke pengecualian tertentu. (Diperoleh dari Exception)
InnerException	Mendapatkan instans Exception yang menyebabkan pengecualian saat ini. (Diperoleh dari Exception)
InnerExceptions	Mendapatkan koleksi Exception instans baca-saja yang menyebabkan pengecualian saat ini.
Message	Mendapatkan pesan yang menjelaskan pengecualian.
Source	Get dan set nama aplikasi atau objek yang menyebabkan kesalahan. (Diperoleh dari Exception)
StackTrace	Mendapatkan representasi string dari bingkai langsung pada tumpukan panggilan. (Diperoleh dari Exception)
TargetSite	Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Flatten()	Meratakan instans AggregateException ke dalam satu instans baru.
GetBaseException()	Mengembalikan AggregateException yang merupakan akar penyebab pengecualian ini.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans AggregateException baru kelas dengan data berseri.
GetType()	Mendapatkan jenis runtime instans saat ini. (Diperoleh dari Exception)
Handle(Func<Exception,Boolean>)	Memanggil handler pada masing-masing Exception yang terkandung oleh ini AggregateException.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Membuat dan mengembalikan representasi string dari saat ini AggregateException.

Acara

SerializeObjectState

Kedaluwarsa. Terjadi ketika pengecualian diserialisasikan untuk membuat objek status pengecualian yang berisi data berseri tentang pengecualian. (Diperoleh dari Exception)

Keamanan Thread

Semua anggota AggregateException publik dan terlindungi aman dari utas dan dapat digunakan secara bersamaan dari beberapa utas.