UnhandledExceptionEventArgs.ExceptionObject Propriedade

Definição

Espaço de Nomes:

System

Assemblagem:

mscorlib.dll

Obtém o objeto de exceção não tratada.

public:
 property System::Object ^ ExceptionObject { System::Object ^ get(); };

public object ExceptionObject { get; }

member this.ExceptionObject : obj

Public ReadOnly Property ExceptionObject As Object

Valor de Propriedade

Object

O objeto de exceção não tratado.

Exemplos

O exemplo seguinte demonstra o UnhandledException evento. Define um gestor de eventos, MyHandler, que é invocado sempre que uma exceção não tratada é lançada no domínio de aplicação predefinido. Depois lança duas exceções. O primeiro é controlado por um bloqueio de tentativa/receção . O segundo não é tratado e invoca a MyHandle rotina antes de a aplicação terminar.

using System;

public class Example
{
   public static void Main()
   {
      AppDomain currentDomain = AppDomain.CurrentDomain;
      currentDomain.UnhandledException += new UnhandledExceptionEventHandler(MyHandler);

      try {
         throw new Exception("1");
      } catch (Exception e) {
         Console.WriteLine("Catch clause caught : {0} \n", e.Message);
      }

      throw new Exception("2");
   }

   static void MyHandler(object sender, UnhandledExceptionEventArgs args)
   {
      Exception e = (Exception) args.ExceptionObject;
      Console.WriteLine("MyHandler caught : " + e.Message);
      Console.WriteLine("Runtime terminating: {0}", args.IsTerminating);
   }
}
// The example displays the following output:
//       Catch clause caught : 1
//
//       MyHandler caught : 2
//       Runtime terminating: True
//
//       Unhandled Exception: System.Exception: 2
//          at Example.Main()

open System
open System.Security.Permissions

let myHandler _ (args: UnhandledExceptionEventArgs) =
    let e = args.ExceptionObject :?> Exception
    printfn $"MyHandler caught : {e.Message}"
    printfn $"Runtime terminating: {args.IsTerminating}"

[<EntryPoint>]
let main _ =
    let currentDomain = AppDomain.CurrentDomain
    currentDomain.UnhandledException.AddHandler(UnhandledExceptionEventHandler myHandler)

    try
        failwith "1"
    with e ->
        printfn $"Catch clause caught : {e.Message} \n"

    failwith "2"

// The example displays the following output:
//       Catch clause caught : 1
//
//       MyHandler caught : 2
//       Runtime terminating: True
//
//       Unhandled Exception: System.Exception: 2
//          at Example.main()

Module Example
   Sub Main()
      Dim currentDomain As AppDomain = AppDomain.CurrentDomain
      AddHandler currentDomain.UnhandledException, AddressOf MyHandler
      
      Try
         Throw New Exception("1")
      Catch e As Exception
         Console.WriteLine("Catch clause caught : " + e.Message)
         Console.WriteLine()
      End Try
      
      Throw New Exception("2")
   End Sub
   
   Sub MyHandler(sender As Object, args As UnhandledExceptionEventArgs)
      Dim e As Exception = DirectCast(args.ExceptionObject, Exception)
      Console.WriteLine("MyHandler caught : " + e.Message)
      Console.WriteLine("Runtime terminating: {0}", args.IsTerminating)
   End Sub
End Module
' The example displays the following output:
'       Catch clause caught : 1
'       
'       MyHandler caught : 2
'       Runtime terminating: True
'       
'       Unhandled Exception: System.Exception: 2
'          at Example.Main()

Observações

Esta propriedade devolve um objeto do tipo Object em vez de um derivado de Exception. Embora a Especificação da Linguagem Comum exija que todos os tipos de exceção derivem de Exception, é possível que os métodos lancem exceções com objetos que não derivam de Exception. Pode fazer o seguinte para trabalhar com esta exceção:

• Aplique o RuntimeCompatibilityAttribute atributo com valor RuntimeCompatibilityAttribute.WrapNonExceptionThrows de true à assembly que contém o handler de eventos. Isto envolve todas as exceções que não derivam da Exception classe num RuntimeWrappedException objeto. Pode então castar (em C#) ou converter (em Visual Basic) o objeto devolvido por esta propriedade num objeto Exception, e recuperar o objeto de exceção original da propriedade RuntimeWrappedException.WrappedException. Note que alguns compiladores, como os compiladores C# e Visual Basic, aplicam automaticamente este atributo.

• Conjure o objeto devolvido por esta propriedade para um Exception objeto.

Ver também

• RuntimeCompatibilityAttribute
• RuntimeWrappedException