【極限の知見】アプリケーションの「死」を食い止める。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)の基本はバッチリですよ」
応援しています。また次の技術講義でお会いしましょう。
