WindowsFormsApplicationBase.UnhandledException Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn die Anwendung auf eine unbehandelte Ausnahme stößt.
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
Beispiele
In diesem Beispiel wird das My.Application.UnhandledException Ereignis verwendet, um alle unbehandelten Ausnahmen zu protokollieren.
Sie müssen den Code im Code-Editor-Fenster für Anwendungsereignisse eingeben. Um auf dieses Fenster zuzugreifen, führen Sie das Verfahren aus, das im Abschnitt "Hinweise" dieses Themas zu finden ist. Weitere Informationen finden Sie auf der Anwendungsseite, Project Designer (Visual Basic).
Da das UnhandledException Ereignis beim Anfügen eines Debuggers an die Anwendung nicht ausgelöst wird, müssen Sie dieses Beispiel außerhalb der integrierten Entwicklungsumgebung von Visual Studio 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 unbehandelte 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 unbehandelte Ausnahme zuzugreifen, die dieses Ereignis verursacht hat.
Mit der ExitApplication Eigenschaft des e Parameters können Sie steuern, ob die Anwendung beendet wird. Standardmäßig ist ExitApplicationTrue. Daher wird die Anwendung nach Abschluss des UnhandledException Ereignishandlers beendet. Sie können den Wert False im UnhandledException Ereignishandler so festlegen, dass die Anwendung ausgeführt wird und sie wieder in einen Wartezustand versetzt wird.
Der Code für den UnhandledException Ereignishandler wird in der ApplicationEvents.vb Datei gespeichert, die standardmäßig ausgeblendet ist.
So greifen Sie auf das Code-Editor-Fenster für Anwendungsereignisse zu: |1. Wenn ein Projekt im 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 den Code-Editor zu öffnen.|
Weitere Informationen finden Sie auf der Anwendungsseite, Project Designer (Visual Basic).
Hinweis
Der Visual Basic-Compiler verhindert, dass Anwendungen, die für das Debuggen erstellt werden, dieses Ereignis auslösen, um einem Debugger die Behandlung der unbehandelten Ausnahmen zu ermöglichen. Dies bedeutet, dass der Ereignishandler nicht aufgerufen wird, UnhandledException wenn Sie die Anwendung testen, indem Sie sie im 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.
| To | Siehe |
|---|---|
| Unbehandelte Ausnahmen protokollieren | Vorgehensweise: Protokollieren von Ausnahmen |
Verfügbarkeit nach Projekttyp
| Projekttyp | Verfügbar |
|---|---|
| Windows Forms-Anwendung | Ja |
| Klassenbibliothek | No |
| Konsolenanwendung | No |
| Windows Forms-Steuerelementbibliothek | No |
| Websteuerelementbibliothek | No |
| Windows-Dienst | No |
| Website | No |
