WindowsFormsApplicationBase.UnhandledException Událost

  • Reference

Definice

Obor názvů:
Microsoft.VisualBasic.ApplicationServices
Sestavení:
Microsoft.VisualBasic.dll
Sestavení:
Microsoft.VisualBasic.Forms.dll

Vyvolá se, 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á My.Application.UnhandledException událost k protokolování všech neošetřených výjimek.

Kód musíte zadat v okně Code Editor pro události aplikace. Pokud chcete získat přístup k tomuto okně, postupujte podle pokynů v části Poznámky k tomuto tématu. Další informace najdete v tématu Stránka aplikace, Projekt Designer (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í modelu aplikace 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.

Pomocí vlastnosti parametru e můžete ExitApplication řídit, 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čí. V obslužné rutině UnhandledException události můžete nastavit hodnotu na False , aby aplikace zůstala spuštěná a vrátila se 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ě Editor kódu pro události aplikace
1. S vybraným projektem v Průzkumník řešení klepněte na tlačítko 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, Projekt Designer (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 zpracovával neošetřené výjimky. To znamená, že pokud testujete aplikaci jejím spuštěním v ladicím programu integrovaného vývojového prostředí sady Visual Studio, nebude vaše UnhandledException obslužná rutina události volána. Další informace o vytváření aplikací pro ladění najdete v tématu /debug (Visual Basic).

Úlohy

V následující tabulce jsou uvedeny 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

Platí pro

Viz také