【入門編】【中級者・実務】VB.NETとWPFでの例外ダイアログ一元管理:DispatcherUnhandledExceptionによる予期せぬクラッシュの防止 – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク
スポンサーリンク

【極限の知見】アプリケーションの「死」を食い止める。WPFにおけるグローバル例外ハンドリングの真髄

こんにちは。現場で数々のシステム崩壊と、そこからの復旧を繰り返してきたチーフアーキテクトです。

あなたがもし、Excelマクロの「動けばいい」というフェーズを終え、「業務で使われる堅牢なソフトウェア」を作ろうとしているなら、今この瞬間に非常に重要な壁にぶつかっています。それは「予期せぬクラッシュ(強制終了)」との戦いです。

ユーザーが一生懸命入力したデータが、ボタンを一つ押した瞬間にアプリが消えて失われる……。これは開発者にとって、技術力の欠如を突きつけられる最も痛い瞬間の一つです。

今日は、WPF(Windows Presentation Foundation)において、アプリを「ただ動かす」レベルから、「プロフェッショナルな品質」へと昇華させるための最強の盾、`DispatcherUnhandledException` を使った例外一元管理について伝授しましょう。

ここをクリアすれば、あなたはVisual Basic (VB.NET)の基本をマスターしたと言っても過言ではありませんよ。

1. なぜ、あなたのアプリは「黙って」死ぬのか?

まず、本質的なメカニズムを理解しましょう。

WPFアプリケーションには、「UIスレッド」という、画面の描画やボタンのクリックを司る「心臓部」があります。この心臓部は、`Dispatcher` という司令塔によって「イベントループ」と呼ばれる無限ループを回しています。

1. マウスが動いた
2. ボタンが押された
3. プログラムの処理を実行する

通常、プログラム内でエラー(例外)が発生しても、`Try…Catch` で適切に捕まえていれば問題ありません。しかし、「どこで発生したか予測できないエラー」がUIスレッドに投げ込まれたとき、`Dispatcher` はその処理方法を知らず、パニックを起こして停止します。これが、アプリがいきなり消える原因です。

私たちが目指すのは、このパニックが起きる直前に「司令塔(Dispatcher)がエラーをキャッチし、ログを書き出し、ユーザーに優しく告げて、アプリを生存させる」という仕組みの構築です。

2. 実装の設計図:App.xaml.vb が「防波堤」になる

例外の一元管理を行う場所は、個別の画面(Window)ではありません。アプリケーション全体の入り口である `App.xaml.vb` です。

ここに、アプリケーション全体を監視する「防波堤」を設置します。

実装コード例:グローバル・エラーハンドラー

以下のコードは、そのままプロジェクトの `App.xaml.vb` に適用できる、実戦的な構成です。

''' <summary>
''' アプリケーション全体を管理するクラス
''' </summary>
Class Application

    ''' <summary>
    ''' アプリケーション起動時に実行される
    ''' </summary>
    Protected Overrides Sub OnStartup(e As StartupEventArgs)
        ' 1. Dispatcherの未処理例外イベントにハンドラを登録
        ' これにより、UIスレッドで発生した「捕まえ損ねたエラー」をここでキャッチできる
        AddHandler Me.DispatcherUnhandledException, AddressOf Global_DispatcherUnhandledException

        MyBase.OnStartup(e)
    End Sub

    ''' <summary>
    ''' UIスレッドで発生した未処理の例外をキャッチするメソッド
    ''' </summary>
    ''' <param name="sender">イベントの発生源</param>
    ''' <param name="e">例外の情報を含むイベント引数</param>
    Private Sub Global_DispatcherUnhandledException(sender As Object, e As System.Windows.Threading.DispatcherUnhandledExceptionEventArgs)
        ' 2. エラー内容を安全にログ出力する
        ' ここでログを出さないと、「なぜ落ちたか」が永遠に分からなくなる
        WriteErrorLog(e.Exception)

        ' 3. ユーザーへの通知
        ' プログラミング的な難解なメッセージではなく、人間が理解できる言葉で伝える
        ShowUserFriendlyError(e.Exception)

        ' ★最重要★ 
        ' e.Handled を True にすることで、「このエラーは私が対処しました(処理済みです)」とDispatcherに伝えます。
        ' これを忘れると、結局アプリはクラッシュして終了してしまいます。
        e.Handled = True
    End Sub

    ''' <summary>
    ''' エラー内容をファイルに書き出す(実務で必須の機能)
    ''' </summary>
    Private Sub WriteErrorLog(ex As Exception)
        Try
            Dim logPath As String = System.IO.Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "error_log.txt")
            Dim logMessage As String = $"[{DateTime.Now:yyyy/MM/dd HH:mm:ss}] ERROR: {ex.Message}{vbCrLf}{ex.StackTrace}{vbCrLf}{New String("-"c, 30)}{vbCrLf}"
            
            ' ファイルの末尾に追記していく
            System.IO.File.AppendAllText(logPath, logMessage)
        Catch
            ' ログ出力自体が失敗した場合は、何もせず(あるいはイベントログへ)
            ' ログ出力の失敗でアプリを落としてはいけない
        End Try
    End Sub

    ''' <summary>
    ''' ユーザーに表示するダイアログ
    ''' </summary>
    Private Sub ShowUserFriendlyError(ex As Exception)
        ' 本来は独自のカスタムダイアログを表示するのが理想的ですが、
        ' ここではシンプルに MessageBox を使用します。
        Dim message As String = "申し訳ありません。予期しない問題が発生しました。" & vbCrLf & vbCrLf &
                                "作業中のデータは保存されていない可能性があります。" & vbCrLf &
                                "恐れ入りますが、アプリを再起動してください。" & vbCrLf & vbCrLf &
                                $"[詳細]: {ex.Message}"

        MessageBox.Show(message, "システムエラー", MessageBoxButton.OK, MessageBoxImage.Error)
    End Sub

End Class

3. アーキテクトが教える「落とし穴」と「極意」

コードを書いただけでは、あなたはまだ半分です。プロのエンジニアとして、以下の3つのポイントを魂に刻んでください。

① `e.Handled = True` は「命綱」である

先ほどのコードの中で、最も重要なのは `e.Handled = True` です。
これは「この例外は私が責任を持って処理したから、もうパニックにならなくていいよ」という合図です。これを書き忘れると、どれだけ丁寧にログを書いても、アプリはそのまま強制終了します。これは、「エラーを捕まえたつもりで、実は逃がしていた」という、中級者が最も陥りやすいミスです。

② 「UIスレッド」と「バックグラウンドスレッド」の違い

今回紹介した `DispatcherUnhandledException` は、あくまでUIスレッド(画面を動かしているスレッド)のエラーを捕まえるものです。
もし、あなたが `Task.Run` などを使って裏側(バックグラウンド)で重い計算をさせている場合、その中で起きたエラーは、このハンドラでは捕まえられません。

もしバックグラウンドのエラーも完全に掌握したいなら、`App.xaml.vb` の `OnStartup` 内で、以下のイベントも併せて登録しておくのが「伝説の設計」への一歩です。

' バックグラウンドスレッドやAppDomain全体の未処理例外を捕まえる
AddHandler AppDomain.CurrentDomain.UnhandledException, AddressOf Global_AppDomainUnhandledException

*(注意: AppDomainの例外は、キャッチできてもアプリの完全な生存は難しい場合が多いですが、ログを残すことは可能です)*

③ ログは「後で自分を助けるための手紙」

`WriteErrorLog` メソッドの中で、`ex.StackTrace` を出力していることに気づきましたか?
単に `ex.Message`(「ファイルが見つかりません」など)だけでは、エンジニアは「どこで」エラーが起きたのか特定できません。`StackTrace` には、「どのファイルの、何行目で、どのメソッドを辿ってエラーになったか」という、犯人探しのための決定的な証拠が詰まっています。これこそが、開発現場でのデバッグ時間を劇的に短縮する鍵です。

まとめ:信頼されるソフトウェアを作るために

エラーは、決して「悪いもの」ではありません。エラーは「システムが限界に達したことを教えてくれる、誠実なサイン」です。

そのサインを無視してアプリを黙って死なせるのか、それとも優雅に受け止めて、ログを記録し、ユーザーに寄り添うのか。その差が、単なる「ツール」と「信頼されるソフトウェア」を分ける境界線なのです。

今回学んだ `DispatcherUnhandledException` の仕組みを使いこなせば、あなたの作るアプリケーションの信頼性は飛躍的に向上します。

さあ、恐れずにコードを書いてください。エラーをコントロールできるようになれば、あなたはもう、プロのエンジニアへの道を力強く歩んでいますよ。

「ここをクリアすれば、Visual Basic (VB.NET)の基本はバッチリですよ」

応援しています。また次の技術講義でお会いしましょう。

タイトルとURLをコピーしました