Condividi tramite


Evento My.Application.UnhandledException

Aggiornamento: Luglio 2008

Viene generato quando nell'applicazione viene rilevata un'eccezione non gestita.

' Usage
Public Sub Me_UnhandledException( _
   ByVal sender As Object, _
   ByVal e As UnhandledExceptionEventArgs _
) Handles Me.UnhandledException
End Sub
' Declaration
Public Event UnhandledException( _
   ByVal sender As Object, _
   ByVal e As UnhandledExceptionEventArgs _
)

Parametri

  • sender
    Object che ha generato l'evento.

  • e
    Oggetto UnhandledExceptionEventArgs che contiene l'eccezione non gestita e ulteriori informazioni.

Note

Un'applicazione genera l'evento UnhandledException quando rileva un'eccezione non gestita. Questo evento fa parte del modello Applicazione di Visual Basic. Per ulteriori informazioni, vedere Cenni preliminari sul modello di applicazione Visual Basic.

È possibile utilizzare la proprietà Exception del parametro e per accedere all'eccezione non gestita che ha generato l'evento.

È possibile utilizzare la proprietà ExitApplication del parametro e per controllare la chiusura dell'applicazione. Per impostazione predefinita, ExitApplication è True, dunque la chiusura dell'applicazione avviene dopo il completamento del gestore eventi UnhandledException. È possibile impostare il valore su False nel gestore eventi UnhandledException per far sì che l'applicazione rimanga in esecuzione e torni in stato di attesa.

Il codice relativo al gestore eventi UnhandledException è archiviato nel file ApplicationEvents.vb, che è nascosto per impostazione predefinita.

Per accedere alla finestra dell'editor del codice per gli eventi applicazioni:

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Applicazione.

  3. Fare clic sul pulsante Visualizza eventi di applicazioni per aprire l'editor di codice.

Per ulteriori informazioni, vedere Procedura: gestire gli eventi di applicazioni (Visual Basic).

Nota:

Il compilatore Visual Basic impedisce alle applicazioni create per il debug di generare questo evento, per consentire al debugger di gestire le eccezioni non gestite. Questo significa che se si esegue il test nell'applicazione tramite il debugger dell'ambiente di sviluppo integrato di Visual Studio, il gestore eventi UnhandledException non verrà chiamato. Per ulteriori informazioni sulla compilazione di applicazioni per il debug, vedere /debug (Visual Basic).

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative all'evento My.Application.UnhandledException.

Per

Vedere

Utilizzare gli eventi forniti dal modello Applicazione di Visual Basic per eseguire codice

Procedura: eseguire codice all'avvio o alla chiusura dell'applicazione

Registrare le eccezioni non gestite

Procedura: registrare eccezioni in Visual Basic

Esempio

Questo esempio utilizza l'evento My.Application.UnhandledException per registrare eventuali eccezioni non gestite.

Private Sub MyApplication_UnhandledException( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs _
) Handles Me.UnhandledException
    My.Application.Log.WriteException(e.Exception, _
        TraceEventType.Critical, _
        "Unhandled Exception.")
End Sub

Inserire il codice nella finestra editor del codice per gli eventi dell'applicazione. Per accedere a questa finestra, attenersi alla procedura descritta nella sezione Note di questo argomento. Per ulteriori informazioni, vedere Procedura: gestire gli eventi di applicazioni (Visual Basic).

Poiché l'evento UnhandledException non viene generato quando il debugger è connesso all'applicazione, è necessario seguire questo esempio al di fuori dell'ambiente di sviluppo integrato di Visual Studio.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto

Disponibile

Applicazione Windows

Libreria di classi

No

Applicazione di console

No

Libreria di controlli Windows

No

Libreria di controllo Web

No

Servizio Windows

No

Sito Web

No

Autorizzazioni

Potrebbero essere necessarie le autorizzazioni riportate di seguito:

Autorizzazione

Descrizione

SecurityPermission

Consente di controllare la capacità di aggiungere un gestore eventi per questo evento. Enumerazione associata: SecurityPermissionFlag.ControlAppDomain.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Concetti

Cenni preliminari sul modello di applicazione Visual Basic

Riferimenti

Oggetto My.Application

Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs

Cronologia delle modifiche

Date

History

Motivo

Luglio 2008

Riviste le informazioni relative all'impostazione del gestore eventi UnhandledException nella sezione Note.

Correzione di errori nel contenuto.