WindowsFormsApplicationBase.UnhandledException Evento

Definizione

Si verifica quando l'applicazione rileva un'eccezione non gestita.

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 evento

Esempio

In questo esempio viene usato l'evento My.Application.UnhandledException per registrare eventuali eccezioni non gestite.

È necessario immettere il codice nella finestra Codice Editor per gli eventi dell'applicazione. Per accedere a questa finestra, seguire la procedura descritta nella sezione Osservazioni di questo argomento. Per altre informazioni, vedere Application Page, Project Designer (Visual Basic).

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

Commenti

Un'applicazione genera l'evento UnhandledException quando rileva un'eccezione non gestita. Questo evento fa parte del modello di applicazione Visual Basic. Per altre informazioni, vedere Panoramica del modello di applicazione Visual Basic.

È possibile usare la Exception proprietà del e parametro per accedere all'eccezione non gestita che ha causato questo evento.

È possibile usare la ExitApplication proprietà del e parametro per controllare se l'applicazione viene chiusa. Per impostazione predefinita, ExitApplication è True. Pertanto, l'applicazione viene chiusa dopo aver completato il UnhandledException gestore eventi. È possibile impostare il valore su False nel UnhandledException gestore eventi per mantenere l'applicazione in esecuzione e tornare a uno stato di attesa.

Il codice per il UnhandledException gestore eventi viene archiviato nel file ApplicationEvents.vb, nascosto per impostazione predefinita.

Per accedere alla finestra Codice Editor per gli eventi dell'applicazione
1. Con un progetto selezionato in Esplora soluzioni, fare clic su Proprietà nel menu Progetto.
2. Fare clic sulla scheda Applicazione .
3. Fare clic sul pulsante Visualizza eventi applicazione per aprire il Editor codice.

Per altre informazioni, vedere 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. Ciò significa che se si sta testando l'applicazione eseguendola nel debugger dell'ambiente di sviluppo integrato di Visual Studio, il UnhandledException gestore eventi non verrà chiamato. Per altre informazioni sulla creazione di applicazioni per il debug, vedere /debug (Visual Basic).

Attività

Nella tabella seguente sono elencati esempi di attività che coinvolgono l'evento My.Application.UnhandledException .

A Vedere
Eccezioni non gestite del log Procedura: Registrare eccezioni

Disponibilità in base al tipo di progetto

Tipo di progetto Disponibile
Windows Forms Application
Libreria di classi No
Applicazione console No
Libreria di controllo Windows Form No
Libreria di controlli Web No
Servizio Windows No
Sito Web No

Si applica a

Vedi anche