Evento My.Application.UnhandledException

Articolo
09/12/2008

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:

Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Applicazione.
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).

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	Sì
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.

Luglio 2008

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

Correzione di errori nel contenuto.

Condividi tramite