AggregateException Klas

Definitie

Naamruimte:

System

Assembly:

mscorlib.dll

Vertegenwoordigt een of meer fouten die optreden tijdens het uitvoeren van de toepassing.

public ref class AggregateException : Exception

[System.Serializable]
public class AggregateException : Exception

[<System.Serializable>]
type AggregateException = class
    inherit Exception

Public Class AggregateException
Inherits Exception

Overname

Object

Exception

AggregateException

Kenmerken

SerializableAttribute

Voorbeelden

In het volgende voorbeeld wordt de AggregateException uitzondering onderschept en wordt de Handle methode aangeroepen om elke uitzondering te verwerken die deze bevat. Het compileren en uitvoeren van het voorbeeld met de eerste task1 variabele moet resulteren in een AggregateException object dat een UnauthorizedAccessException uitzondering bevat. Als u deze regel uitcommentarieert, de opmerkingen bij de tweede task1 variabele opheffen en het voorbeeld compileren en uitvoeren, wordt een AggregateException object gegenereerd dat een IndexOutOfRangeException uitzondering bevat.

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)
      {
          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

Opmerkingen

AggregateException wordt gebruikt om meerdere fouten samen te voegen in één object voor het genereren van uitzonderingen. Het wordt uitgebreid gebruikt in de Task Parallel Library (TPL) en Parallel LINQ (PLINQ). Zie Uitzonderingsafhandeling en procedures voor meer informatie: Uitzonderingen verwerken in een PLINQ-query. Zie de vermelding Aggregating Exceptions in de blog .NET Matters voor meer informatie.

Constructors

Name	Description
AggregateException()	Initialiseert een nieuw exemplaar van de klasse met een door het AggregateException systeem opgegeven bericht waarin de fout wordt beschreven.
AggregateException(Exception[])	Initialiseert een nieuw exemplaar van de AggregateException klasse met verwijzingen naar de binnenste uitzonderingen die de oorzaak van deze uitzondering zijn.
AggregateException(IEnumerable<Exception>)	Initialiseert een nieuw exemplaar van de AggregateException klasse met verwijzingen naar de binnenste uitzonderingen die de oorzaak van deze uitzondering zijn.
AggregateException(SerializationInfo, StreamingContext)	Initialiseert een nieuw exemplaar van de AggregateException klasse met geserialiseerde gegevens.
AggregateException(String, Exception)	Initialiseert een nieuw exemplaar van de AggregateException klasse met een opgegeven foutbericht en een verwijzing naar de binnenste uitzondering die de oorzaak van deze uitzondering is.
AggregateException(String, Exception[])	Initialiseert een nieuw exemplaar van de AggregateException klasse met een opgegeven foutbericht en verwijzingen naar de binnenste uitzonderingen die de oorzaak van deze uitzondering zijn.
AggregateException(String, IEnumerable<Exception>)	Initialiseert een nieuw exemplaar van de AggregateException klasse met een opgegeven foutbericht en verwijzingen naar de binnenste uitzonderingen die de oorzaak van deze uitzondering zijn.
AggregateException(String)	Initialiseert een nieuw exemplaar van de AggregateException klasse met een opgegeven bericht waarin de fout wordt beschreven.

Eigenschappen

Name	Description
Data	Hiermee haalt u een verzameling sleutel-waardeparen op die aanvullende door de gebruiker gedefinieerde informatie over de uitzondering bieden. (Overgenomen van Exception)
HelpLink	Hiermee haalt u een koppeling op naar het Help-bestand dat aan deze uitzondering is gekoppeld. (Overgenomen van Exception)
HResult	Hiermee wordt HRESULT opgehaald of ingesteld, een gecodeerde numerieke waarde die is toegewezen aan een specifieke uitzondering. (Overgenomen van Exception)
InnerException	Hiermee haalt u het Exception exemplaar op dat de huidige uitzondering heeft veroorzaakt. (Overgenomen van Exception)
InnerExceptions	Hiermee haalt u een alleen-lezen verzameling op van de Exception exemplaren die de huidige uitzondering hebben veroorzaakt.
Message	Hiermee wordt een bericht weergegeven waarin de huidige uitzondering wordt beschreven. (Overgenomen van Exception)
Source	Hiermee wordt de naam van de toepassing of het object dat de fout veroorzaakt, opgehaald of ingesteld. (Overgenomen van Exception)
StackTrace	Hiermee haalt u een tekenreeksweergave van de directe frames op de aanroepstack op. (Overgenomen van Exception)
TargetSite	Hiermee haalt u de methode op waarmee de huidige uitzondering wordt gegenereerd. (Overgenomen van Exception)

Methoden

Name	Description
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
Flatten()	Een exemplaar plat maken AggregateException in één, nieuw exemplaar.
GetBaseException()	Retourneert de Exception hoofdoorzaak van deze uitzondering. Deze uitzondering is de hoofduitzondering of de eerste AggregateException die meerdere binnenste uitzonderingen of helemaal geen interne uitzonderingen bevat.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetObjectData(SerializationInfo, StreamingContext)	Initialiseert een nieuw exemplaar van de AggregateException klasse met geserialiseerde gegevens.
GetType()	Hiermee haalt u het runtimetype van het huidige exemplaar op. (Overgenomen van Exception)
Handle(Func<Exception,Boolean>)	Roept een handler aan op elke Exception handler die hierin is AggregateExceptionopgenomen.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Hiermee wordt een tekenreeksweergave van de huidige AggregateExceptiongemaakt en geretourneerd.

gebeurtenis

Name	Description
SerializeObjectState	Treedt op wanneer een uitzondering wordt geserialiseerd om een uitzonderingsstatusobject te maken dat geserialiseerde gegevens over de uitzondering bevat. (Overgenomen van Exception)

Veiligheid thread

Alle openbare en beveiligde leden van AggregateException zijn thread-veilig en kunnen gelijktijdig worden gebruikt vanuit meerdere threads.