WindowsFormsApplicationBase.UnhandledException Událost

Definice

Obor názvů:

Microsoft.VisualBasic.ApplicationServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

Nastane, když aplikace narazí na neošetřenou výjimku.

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 

Event Type

UnhandledExceptionEventHandler

Příklady

Tento příklad používá událost k My.Application.UnhandledException protokolování všech neošetřených výjimek.

Pro události aplikace musíte zadat kód v okně Editor kódu. K tomuto okně se dostanete podle postupu, který najdete v části Poznámky k tomuto tématu. Další informace najdete v tématu Stránka aplikace, Návrhář projektu (Visual Basic).

Vzhledem k tomu, že UnhandledException událost není vyvolána, když je k aplikaci připojen ladicí program, musíte tento příklad spustit mimo integrované vývojové prostředí sady 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

Poznámky

Aplikace vyvolá událost, UnhandledException když narazí na neošetřenou výjimku. Tato událost je součástí aplikačního modelu jazyka Visual Basic. Další informace najdete v tématu Přehled aplikačního modelu jazyka Visual Basic.

Vlastnost parametru Exceptione můžete použít pro přístup k neošetřené výjimce, která způsobila tuto událost.

Vlastnost parametru ExitApplicatione můžete použít k řízení, jestli se aplikace ukončí. Ve výchozím nastavení ExitApplication je True. Proto se aplikace po dokončení obslužné UnhandledException rutiny události ukončí. Můžete nastavit hodnotu na False v obslužné rutině UnhandledException události, aby aplikace zůstala spuštěná a aby se vrátila do čekající stavu.

Kód obslužné rutiny UnhandledException události je uložen v souboru ApplicationEvents.vb, který je ve výchozím nastavení skrytý.

Přístup k okně Editoru kódu pro události aplikace
1. S vybraným projektem v Průzkumníku řešení klikněte na Vlastnosti v nabídce Projekt . 2. Klikněte na kartu Aplikace . 3. Kliknutím na tlačítko Zobrazit události aplikace otevřete Editor kódu.

Další informace najdete v tématu Stránka aplikace, Návrhář projektu (Visual Basic).

Poznámka

Kompilátor jazyka Visual Basic zabraňuje aplikacím, které jsou vytvořeny pro ladění v vyvolání této události, aby ladicí program mohl zpracovávat neošetřené výjimky. To znamená, že pokud testujete aplikaci spuštěním v ladicím programu integrovaného vývojového prostředí sady Visual Studio, UnhandledException obslužná rutina události nebude volána. Další informace o vytváření aplikací pro ladění najdete v tématu /debug (Visual Basic).

Úlohy

Následující tabulka uvádí příklady úkolů, které zahrnují událost My.Application.UnhandledException .

Záměr	Seznamte se s
Protokolování neošetřených výjimek	Postupy: Protokolování výjimek

Dostupnost podle typu projektu

Typ projektu	K dispozici.
Formulářová aplikace Windows	Ano
Knihovna tříd	No
Konzolová aplikace	No
Knihovna ovládacích prvků formulářů Windows	No
Knihovna webových ovládacích prvků	No
Služba systému Windows	No
Webu	No

Viz také

• WindowsFormsApplicationBase
• Microsoft.VisualBasic.ApplicationServices
• UnhandledExceptionEventHandler
• UnhandledExceptionEventArgs
• Objekty (Visual Basic)
• Přehled aplikačního modelu jazyka Visual Basic