WindowsFormsApplicationBase.UnhandledException イベント

定義

アプリケーションがハンドルされない例外を検出したときに発生します。

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 

イベントの種類

この例では、 My.Application.UnhandledException イベントを使用して、未処理の例外をログに記録します。

アプリケーション イベントのコード エディター ウィンドウにコードを入力する必要があります。 このウィンドウにアクセスするには、このトピックの「解説」セクションの手順に従います。 詳細については、 アプリケーション ページ、プロジェクト デザイナー (Visual Basic)を参照してください。

デバッガーがアプリケーションにアタッチされている場合、 UnhandledException イベントは発生しないため、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

注釈

アプリケーションは、ハンドルされない例外が発生したときに UnhandledException イベントを発生させます。 このイベントは、Visual Basic アプリケーション モデルの一部です。 詳細については、「 Visual Basic アプリケーション モデルの概要」を参照してください。

Exception パラメーターの e プロパティを使用して、このイベントの原因となった未処理の例外にアクセスできます。

ExitApplication パラメーターの e プロパティを使用して、アプリケーションが終了するかどうかを制御できます。 既定では、ExitApplicationTrueです。 そのため、アプリケーションは、 UnhandledException イベント ハンドラーの完了後に終了します。 False イベント ハンドラーで値をUnhandledExceptionに設定して、アプリケーションの実行を維持し、待機状態に戻すことができます。

UnhandledException イベント ハンドラーのコードは、既定では非表示になっているApplicationEvents.vb ファイルに格納されます。

アプリケーション イベントのコード エディター ウィンドウにアクセスするには: |1。 ソリューション エクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
2. [ アプリケーション ] タブをクリックします。
3. [ アプリケーション イベントの表示 ] ボタンをクリックしてコード エディターを開きます。

詳細については、 アプリケーション ページ、プロジェクト デザイナー (Visual Basic)を参照してください。

Note

Visual Basic コンパイラでは、デバッグ用にビルドされたアプリケーションでこのイベントが発生するのを防ぎ、デバッガーがハンドルされない例外を処理できるようにします。 つまり、Visual Studio 統合開発環境デバッガーでアプリケーションを実行してアプリケーションをテストしている場合、 UnhandledException イベント ハンドラーは呼び出されません。 デバッグ用のアプリケーションのビルドの詳細については、「 /debug (Visual Basic)」を参照してください。

タスク

次の表に、 My.Application.UnhandledException イベントに関連するタスクの例を示します。

ターゲット 参照先
ハンドルされない例外をログに記録する 方法: 例外をログに記録する

プロジェクトの種類別の可用性

プロジェクト タイプ 在庫有り
Windows フォーム アプリケーション Yes
クラス ライブラリ いいえ
コンソール アプリケーション いいえ
Windows フォーム コントロール ライブラリ いいえ
Web コントロール ライブラリ いいえ
Windows サービス いいえ
ウェブサイト いいえ

適用対象

こちらもご覧ください