WindowsFormsApplicationBase.UnhandledException Evento

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.ApplicationServices
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

Se produce si la aplicación detecta una excepción no controlada.

public:
 event Microsoft::VisualBasic::ApplicationServices::UnhandledExceptionEventHandler ^ UnhandledException;
public event Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventHandler UnhandledException;
member this.UnhandledException : Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventHandler 
Public Custom Event UnhandledException As UnhandledExceptionEventHandler

Tipo de evento

UnhandledExceptionEventHandler

Ejemplos

En este ejemplo se usa el My.Application.UnhandledException evento para registrar las excepciones no controladas.

Debe escribir el código en la ventana Código Editor para eventos de aplicación. Para acceder a esta ventana, siga el procedimiento que se encuentra en la sección Comentarios de este tema. Para obtener más información, consulte Application Page, Project Designer (Visual Basic).

Dado que el UnhandledException evento no se genera cuando se adjunta un depurador a la aplicación, debe ejecutar este ejemplo fuera del entorno de desarrollo integrado de Visual Studio.

Private Sub MyApplication_UnhandledException(
    sender As Object,
    e As Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs
) Handles Me.UnhandledException

    My.Application.Log.WriteException(e.Exception,
        TraceEventType.Critical,
        "Unhandled Exception.")
End Sub

Comentarios

Una aplicación genera el UnhandledException evento cuando encuentra una excepción no controlada. Este evento forma parte del modelo de aplicación de Visual Basic. Para obtener más información, vea Información general sobre el modelo de aplicación de Visual Basic.

Puede usar la Exception propiedad del e parámetro para tener acceso a la excepción no controlada que provocó este evento.

Puede usar la ExitApplication propiedad del e parámetro para controlar si se cierra la aplicación. De manera predeterminada, ExitApplication es True. Por lo tanto, la aplicación se cierra después de completar el UnhandledException controlador de eventos. Puede establecer el valor False en en en el UnhandledException controlador de eventos para mantener la aplicación en ejecución y hacer que vuelva a un estado de espera.

El código del UnhandledException controlador de eventos se almacena en el archivo ApplicationEvents.vb, que está oculto de forma predeterminada.
Para acceder a la ventana Código Editor para eventos de aplicación
1. Con un proyecto seleccionado en Explorador de soluciones, haga clic en Propiedades en el menú Proyecto.
2. Haz clic en la pestaña Aplicación.
3. Haga clic en el botón Ver eventos de aplicación para abrir el código Editor.

Para obtener más información, consulte Application Page, Project Designer (Visual Basic).

Nota

El compilador de Visual Basic impide que las aplicaciones compiladas para la depuración generen este evento, para permitir que un depurador controle las excepciones no controladas. Esto significa que si va a probar la aplicación ejecutándola en el depurador del entorno de desarrollo integrado de Visual Studio, UnhandledException no se llamará al controlador de eventos. Para obtener más información sobre cómo compilar aplicaciones para la depuración, vea /debug (Visual Basic) .

Tareas

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Application.UnhandledException evento.

En Vea
Registrar excepciones no controladas Cómo: Registrar excepciones

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación de Windows Forms Sí
Biblioteca de clases No
Aplicación de consola No
Biblioteca de controles de Windows Forms No
Biblioteca de controles web No
Servicio de Windows No
Sitio web No

Se aplica a

Consulte también