WindowsFormsApplicationBase.UnhandledException WindowsFormsApplicationBase.UnhandledException WindowsFormsApplicationBase.UnhandledException WindowsFormsApplicationBase.UnhandledException Event

Definizione

Si verifica quando l'applicazione rileva un'eccezione non gestita.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 

Esempi

In questo esempio viene My.Application.UnhandledException usato l'evento per registrare eventuali eccezioni non gestite.This example uses the My.Application.UnhandledException event to log any unhandled exceptions.

È necessario immettere il codice nella finestra dell'editor di codice per gli eventi dell'applicazione.You must enter the code in the Code Editor window for application events. Per accedere a questa finestra, attenersi alla procedura illustrata nella sezione Osservazioni di questo argomento.To access this window, follow the procedure found in this topic's Remarks section. Per altre informazioni, vedere Pagina Applicazione, Creazione progetti (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Poiché l' UnhandledException evento non viene generato quando un debugger è collegato all'applicazione, è necessario eseguire questo esempio al di fuori dell'ambiente di sviluppo integrato di 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

Commenti

Un'applicazione genera l' UnhandledException evento quando rileva un'eccezione non gestita.An application raises the UnhandledException event when it encounters an unhandled exception. Questo evento fa parte del modello di applicazione Visual Basic.This event is part of the Visual Basic Application model. Per ulteriori informazioni, vedere Panoramica del modello di applicazione Visual Basic.For more information, see Overview of the Visual Basic Application Model.

È possibile utilizzare la Exception proprietà e del parametro per accedere all'eccezione non gestita che ha causato l'evento.You can use the Exception property of the e parameter to access the unhandled exception that caused this event.

È possibile utilizzare la ExitApplication proprietà e del parametro per controllare se l'applicazione viene chiusa.You can use the ExitApplication property of the e parameter to control whether the application exits. Per impostazione predefinita ExitApplication , Trueè.By default, ExitApplication is True. Quindi, l'applicazione viene chiusa dopo aver completato UnhandledException il gestore eventi.Therefore, the application exits after completing the UnhandledException event handler. È possibile impostare il valore su False UnhandledException nel gestore eventi per lasciare l'applicazione in esecuzione e tornare a uno stato di attesa.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.

Il codice per il UnhandledException gestore eventi è archiviato nel file ApplicationEvents. vb, che è nascosto per impostazione predefinita.The code for the UnhandledException event handler is stored in the ApplicationEvents.vb file, which is hidden by default.

Per accedere alla finestra dell'editor di codice per gli eventi dell'applicazioneTo access the Code Editor window for application events
1. Con un progetto selezionato in Esplora soluzioni, fare clic su Proprietà nel menu progetto .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Fare clic sulla scheda Applicazione .2. Click the Application tab.
3. Fare clic sul pulsante Visualizza eventi applicazione per aprire l'editor di codice.3. Click the View Application Events button to open the Code Editor.

Per altre informazioni, vedere Pagina Applicazione, Creazione progetti (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Nota

Il compilatore Visual Basic impedisce alle applicazioni compilate per il debug di generare questo evento, per consentire a un debugger di gestire le eccezioni non gestite.The Visual Basic compiler prevents applications that are built for debugging from raising this event, to enable a debugger to handle the unhandled exceptions. Ciò significa che se si sta testando l'applicazione eseguendola nel debugger dell'ambiente di sviluppo integrato di Visual Studio UnhandledException , il gestore eventi non verrà chiamato.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. Per ulteriori informazioni sulla compilazione di applicazioni per il debug, vedere /debug (Visual Basic).For more information about building applications for debugging, see /debug (Visual Basic).

AttivitàTasks

Nella tabella seguente sono elencati alcuni esempi di attività che My.Application.UnhandledException coinvolgono l'evento.The following table lists examples of tasks that involve the My.Application.UnhandledException event.

ATo VedereSee
Registrare le eccezioni non gestiteLog unhandled exceptions Procedura: Registrare eccezioniHow to: Log Exceptions

Disponibilità per tipo di progettoAvailability by Project Type

Tipo di progettoProject type DisponibileAvailable
Windows Forms ApplicationWindows Forms Application Yes
Libreria di classiClass Library NoNo
Applicazione consoleConsole Application NoNo
Libreria di controllo Windows FormWindows Forms Control Library NoNo
Libreria di controlli WebWeb Control Library NoNo
Servizio WindowsWindows Service NoNo
Sito WebWeb Site NoNo

Sicurezza

SecurityPermission
Controlla la possibilità di aggiungere un gestore eventi per questo evento.Controls the ability to add an event handler for this event. Enumerazione associata: ControlAppDomain.Associated enumeration: ControlAppDomain.

Si applica a

Vedi anche