UnhandledExceptionEventArgs.ExceptionObject Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

UnhandledExceptionEventArgs.cs

Obtém o objeto de exceção sem tratamento.

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

public object ExceptionObject { get; }

member this.ExceptionObject : obj

Public ReadOnly Property ExceptionObject As Object

Valor da propriedade

Object

O objeto de exceção sem tratamento.

Exemplos

O exemplo a seguir demonstra o UnhandledException evento. Ele define um manipulador de eventos, MyHandler, que é invocado sempre que uma exceção sem tratamento é lançada no domínio do aplicativo padrão. Em seguida, ele gera duas exceções. O primeiro é tratado por um bloco try/catch . O segundo é sem tratamento e invoca a MyHandle rotina antes que o aplicativo seja encerrado.

// The example should be compiled with the /clr:pure compiler option.
using namespace System;
using namespace System::Security::Permissions;

public ref class Example
{


private:
   static void MyHandler(Object^ sender, UnhandledExceptionEventArgs^ args)
   {
      Exception^ e = dynamic_cast<Exception^>(args->ExceptionObject);
      Console::WriteLine( "MyHandler caught : {0}", e->Message );
      Console::WriteLine("Runtime terminating: {0}", args->IsTerminating);
   }
   
public: 
   [SecurityPermissionAttribute( SecurityAction::Demand, ControlAppDomain = true )]
   static void Main()
   {
      AppDomain^ currentDomain = AppDomain::CurrentDomain;
      currentDomain->UnhandledException += gcnew UnhandledExceptionEventHandler(Example::MyHandler);
      try
      {
         throw gcnew Exception("1");
      }
      catch (Exception^ e) 
      {
         Console::WriteLine( "Catch clause caught : {0}\n", e->Message );
      }

      throw gcnew Exception("2");
   }
};

void main()
{
   Example::Main();
}   
// The example displays the following output:
//       Catch clause caught : 1
//       
//       MyHandler caught : 2
//       Runtime terminating: True
//       
//       Unhandled Exception: System.Exception: 2
//          at Example.Main()
//          at mainCRTStartup(String[] arguments)

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

Comentários

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

• Aplique o RuntimeCompatibilityAttribute atributo com um RuntimeCompatibilityAttribute.WrapNonExceptionThrows valor de true ao assembly que contém o manipulador de eventos. Isso encapsula todas as exceções não derivadas da Exception classe em um RuntimeWrappedException objeto . Em seguida, você pode converter com segurança (em C#) ou converter (no Visual Basic) o objeto retornado por essa propriedade em um Exception objeto e recuperar o objeto de exceção original da RuntimeWrappedException.WrappedException propriedade. Observe que alguns compiladores, como os compiladores C# e Visual Basic, aplicam automaticamente esse atributo.

• Converta o objeto retornado por essa propriedade em um Exception objeto .

Confira também

• RuntimeCompatibilityAttribute
• RuntimeWrappedException