WindowsFormsApplicationBase.UnhandledException Evento

Definición

Se produce si la aplicación detecta una excepción no controlada.Occurs when the application encounters an unhandled exception.

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 utiliza el My.Application.UnhandledException evento para registrar cualquier excepción no controlada.This example uses the My.Application.UnhandledException event to log any unhandled exceptions.

Debe escribir el código en la ventana del editor de código para los eventos de aplicación.You must enter the code in the Code Editor window for application events. Para obtener acceso a esta ventana, siga el procedimiento que se encuentra en la sección Comentarios de este tema.To access this window, follow the procedure found in this topic's Remarks section. Para obtener más información, consulte Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Dado que el UnhandledException evento no se genera cuando se adjunta un depurador a la aplicación, tiene que ejecutar este ejemplo fuera del entorno de desarrollo integrado de Visual Studio.Because the UnhandledException event is not raised when a debugger is attached to the application, you have to run this example outside the Visual Studio Integrated Development Environment.

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.An application raises the UnhandledException event when it encounters an unhandled exception. Este evento forma parte del modelo de aplicación Visual Basic.This event is part of the Visual Basic Application model. Para obtener más información, vea información general sobre el modelo de aplicación Visual Basic.For more information, see Overview of the Visual Basic Application Model.

Puede utilizar la Exception propiedad del e parámetro para tener acceso a la excepción no controlada que provocó este evento.You can use the Exception property of the e parameter to access the unhandled exception that caused this event.

Puede usar la ExitApplication propiedad del e parámetro para controlar si la aplicación se cierra.You can use the ExitApplication property of the e parameter to control whether the application exits. De forma predeterminada, ExitApplication es True .By default, ExitApplication is True. Por lo tanto, la aplicación se cierra después de completar el UnhandledException controlador de eventos.Therefore, the application exits after completing the UnhandledException event handler. Puede establecer el valor False en en el UnhandledException controlador de eventos para mantener la aplicación en ejecución y volver a un estado de espera.You can set the value to False in the UnhandledException event handler to keep the application running, and have it return to a waiting state.

El código del UnhandledException controlador de eventos se almacena en el archivo ApplicationEvents. VB, que está oculto de forma predeterminada.The code for the UnhandledException event handler is stored in the ApplicationEvents.vb file, which is hidden by default.

Para tener acceso a la ventana del editor de código para eventos de aplicaciónTo access the Code Editor window for application events
1. con un proyecto seleccionado en Explorador de soluciones, haga clic en propiedades en el menú proyecto .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Haga clic en la pestaña Aplicación .2. Click the Application tab.
3. Haga clic en el botón ver eventos de aplicación para abrir el editor de código.3. Click the View Application Events button to open the Code Editor.

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

Nota

El compilador Visual Basic impide que las aplicaciones que se compilan para la depuración generen este evento, para permitir que un depurador controle las excepciones no controladas.The Visual Basic compiler prevents applications that are built for debugging from raising this event, to enable a debugger to handle the unhandled exceptions. Esto significa que, si va a probar la aplicación mediante la ejecución en el depurador del entorno de desarrollo integrado de Visual Studio, UnhandledException no se llamará al controlador de eventos.This means that if you are testing your application by running it under the Visual Studio Integrated Development Environment debugger, your UnhandledException event handler will not be called. Para obtener más información sobre la creación de aplicaciones para la depuración, vea /debug (Visual Basic).For more information about building applications for debugging, see /debug (Visual Basic).

TareasTasks

En la tabla siguiente se muestran ejemplos de tareas que implican el My.Application.UnhandledException evento.The following table lists examples of tasks that involve the My.Application.UnhandledException event.

EnTo VeaSee
Registrar excepciones no controladasLog unhandled exceptions Cómo: Registrar excepcionesHow to: Log Exceptions

Disponibilidad por tipo de proyectoAvailability by Project Type

Tipo de proyectoProject type DisponibleAvailable
Aplicación de Windows FormsWindows Forms Application Yes
Biblioteca de clasesClass Library NoNo
Aplicación de consolaConsole Application NoNo
Biblioteca de controles de Windows FormsWindows Forms Control Library NoNo
Biblioteca de controles webWeb Control Library NoNo
Servicio de WindowsWindows Service NoNo
Sitio webWeb Site NoNo

Se aplica a

Consulte también