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á My.Application.UnhandledException událost k protokolování všech neošetřených výjimek.
Kód je nutné zadat v okně Editor kódu pro události aplikace. Pokud chcete získat přístup k tomuto okně, postupujte podle postupu, který najdete v části Poznámky tohoto tématu. Další informace naleznete v tématu Stránka aplikace, Návrhář projektu (Visual Basic).
Vzhledem k tomu, že událost UnhandledException není vyvolána při připojení ladicího programu k aplikaci, 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á UnhandledException událost, když dojde k neošetřené výjimce. 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 e můžete použít Exception pro přístup k neošetřené výjimce, která způsobila tuto událost.
Vlastnost parametru ExitApplicatione můžete použít k řízení, zda aplikace ukončí. Ve výchozím nastavení je ExitApplicationTrue. Aplikace se proto ukončí po dokončení UnhandledException obslužné rutiny události. Můžete nastavit hodnotu v False obslužné rutině UnhandledException události, aby byla aplikace spuštěná, a nechat ji vrátit do stavu čekání.
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. Pokud je projekt vybraný v Průzkumníku řešení, klikněte v nabídce Projekt na Příkaz Vlastnosti.
2. Klikněte na kartu Aplikace .
3. Kliknutím na tlačítko Zobrazit události aplikace otevřete Editor kódu.|
Další informace naleznete v tématu Stránka aplikace, Návrhář projektu (Visual Basic).
Poznámka:
Kompilátor jazyka Visual Basic zabraňuje aplikacím vytvořeným 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álostí se nebude volat. Další informace o vytváření aplikací pro ladění naleznete v tématu /debug (Visual Basic).
Úlohy
Následující tabulka uvádí příklady úkolů, které zahrnují My.Application.UnhandledException událost.
| To | Viz |
|---|---|
| Neošetřené výjimky protokolu | Postupy: Protokolování výjimek |
Dostupnost podle typu projektu
| Typ projektu | K dispozici |
|---|---|
| Aplikace Windows Forms | Ano |
| Knihovna tříd | Ne |
| Konzolová aplikace | Ne |
| Knihovna ovládacích prvků Windows Forms | Ne |
| Knihovna webových ovládacích prvků | Ne |
| Služba systému Windows | Ne |
| Webu | Ne |