WindowsFormsApplicationBase.UnhandledException Ereignis

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic.ApplicationServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Kommt vor, wenn in der Anwendung eine unbehandelte Ausnahme auftritt.

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

Ereignistyp

UnhandledExceptionEventHandler

Beispiele

In diesem Beispiel wird das My.Application.UnhandledException -Ereignis verwendet, um alle nicht behandelten Ausnahmen zu protokollieren.

Sie müssen den Code im Fenster Code Editor für Anwendungsereignisse eingeben. Um auf dieses Fenster zuzugreifen, führen Sie das Verfahren aus, das sie im Abschnitt Hinweise dieses Themas finden. Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).

Da das UnhandledException Ereignis nicht ausgelöst wird, wenn ein Debugger an die Anwendung angefügt wird, müssen Sie dieses Beispiel außerhalb der integrierten Visual Studio-Entwicklungsumgebung ausführen.

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

Hinweise

Eine Anwendung löst das UnhandledException Ereignis aus, wenn eine nicht behandelte Ausnahme auftritt. Dieses Ereignis ist Teil des Visual Basic-Anwendungsmodells. Weitere Informationen finden Sie unter Übersicht über das Visual Basic-Anwendungsmodell.

Sie können die Exception -Eigenschaft des e Parameters verwenden, um auf die nicht behandelte Ausnahme zuzugreifen, die dieses Ereignis verursacht hat.

Sie können die ExitApplication -Eigenschaft des e Parameters verwenden, um zu steuern, ob die Anwendung beendet wird. ExitApplication ist standardmäßig True. Daher wird die Anwendung nach Abschluss des UnhandledException Ereignishandlers beendet. Sie können den Wert im UnhandledException Ereignishandler auf False festlegen, damit die Anwendung ausgeführt wird, und sie in einen Wartezustand zurückkehren lässt.

Der Code für den UnhandledException Ereignishandler wird in der ApplicationEvents.vb-Datei gespeichert, die standardmäßig ausgeblendet ist.
So greifen Sie auf das Fenster Code Editor für Anwendungsereignisse zu
1. Wenn ein Projekt in Projektmappen-Explorer ausgewählt ist, klicken Sie im Menü Projekt auf Eigenschaften.
2. Klicken Sie auf die Registerkarte Anwendung.
3. Klicken Sie auf die Schaltfläche Anwendungsereignisse anzeigen, um die Code-Editor zu öffnen.

Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).

Hinweis

Der Visual Basic-Compiler verhindert, dass Anwendungen, die für das Debuggen erstellt werden, dieses Ereignis auslösen, damit ein Debugger die nicht behandelten Ausnahmen behandeln kann. Dies bedeutet, dass Ihr Ereignishandler nicht aufgerufen wird, wenn Sie Ihre Anwendung testen, UnhandledException indem Sie sie unter dem Debugger der integrierten Entwicklungsumgebung von Visual Studio ausführen. Weitere Informationen zum Erstellen von Anwendungen zum Debuggen finden Sie unter /debug (Visual Basic).

Aufgaben

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die das My.Application.UnhandledException Ereignis betreffen.

Beschreibung Siehe
Protokollieren nicht behandelter Ausnahmen How to: Protokollieren von Ausnahmen

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows Forms-Anwendung Ja
Klassenbibliothek Nein
Konsolenanwendung Nein
Windows Forms-Steuerelementbibliothek Nein
Websteuerelementbibliothek Nein
Windows-Dienst Nein
Website Nein

Gilt für:

Weitere Informationen