WindowsFormsApplicationBase.UnhandledException Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 Editor di codice per gli eventi dell'applicazione. Per accedere a questa finestra, seguire la procedura descritta nella sezione Osservazioni di questo argomento. Per altre informazioni, vedere Pagina applicazione, Progettazione progetti (Visual Basic).For more information, see 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 utilizzare la Exception proprietà del e parametro per accedere all'eccezione non gestita che ha causato questo evento.
È possibile utilizzare 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 Editor di codice per gli eventi dell'applicazione: |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 applicazione per aprire l'editor di codice.|
Per altre informazioni, vedere Pagina applicazione, Progettazione progetti (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).
Annotazioni
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 compilazione di applicazioni per il debug, vedere /debug (Visual Basic).For more information about building applications for debugging, see /debug (Visual Basic).
Attività
Nella tabella seguente sono elencati esempi di attività che coinvolgono l'evento My.Application.UnhandledException .
| Per | Visualizza |
|---|---|
| Registrare eccezioni non gestite | Procedura: Registrare le eccezioni |
Disponibilità per tipo di progetto
| Tipo di progetto | Disponibile |
|---|---|
| Applicazione Windows Form | Sì |
| Libreria di classi | No |
| Applicazione console | No |
| Libreria di controlli Windows Form | No |
| Libreria di controlli Web | No |
| Servizio Windows | No |
| Sito web | No |