WindowsFormsApplicationBase.UnhandledException Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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 Editor de código 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 Editor de código para eventos de aplicación |
| 1. Con un proyecto seleccionado en el 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 Editor de código. |
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 |
