WindowsFormsApplicationBase.UnhandledException Událost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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 |