「その場しのぎ」のダイアログから卒業しよう：Windows Formsを極める堅牢なファイル選択ラッパー設計
こんにちは。現場で叩き上げられたエンジニアなら一度は直面する「ダイアログの罠」。
「とりあえず `OpenFileDialog` を貼り付けて `ShowDialog()` すれば動くでしょ？」と考えているなら、それはまだプロの入り口に立ったばかりです。
現場のシステムは、ユーザーの予期せぬ操作や、存在しないパス、さらには異常終了と常に隣り合わせです。今日は、VB.NETのWindows Formsにおいて、「壊れない、忘れない、迷わない」ファイル選択処理を実現するための、洗練されたラッパー設計術を伝授します。
—
1. なぜ「そのまま」使ってはいけないのか？
標準の `OpenFileDialog` をベタ書きすると、以下のような問題が必ず発生します。
- 記憶喪失: アプリを再起動するたびに、選択ディレクトリがデフォルト（デスクトップ等）に戻ってしまう。
- 脆弱性: ユーザーがキャンセルしたり、不正なパスを選択したりした際の「例外処理」が漏れている。
- コードの散乱: フォームごとに同じような設定をコピペし、保守性が地に落ちる。
これらを解決するのは「ラッパー（包み紙）」の役割です。共通クラスとして切り出し、再利用可能な武器に仕立て上げましょう。
—
2. 賢いラッパー設計：`FileDialogService` の実装
ここでは、`InitialDirectory` を永続化（保存）し、安全にパスを取得するクラスを構築します。
Imports System.IO
Imports System.Windows.Forms
”’
”’
Public Class FileDialogService
‘ 最後に開いたディレクトリを記憶しておくための静的変数
Private Shared _lastDirectory As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
”’
”’
Public Shared Function GetFilePath(filter As String) As String
Using ofd As New OpenFileDialog()
‘ 設定の適用
ofd.InitialDirectory = _lastDirectory
ofd.Filter = filter
ofd.Title = “ファイルを選択してください”
‘ ダイアログ表示と結果の検証
If ofd.ShowDialog() = DialogResult.OK Then
‘ 選択されたパスを記憶
_lastDirectory = Path.GetDirectoryName(ofd.FileName)
Return ofd.FileName
End If
End Using
‘ キャンセル時、あるいは選択失敗時は空文字を返す
Return String.Empty
End Function
End Class
このコードの「魂」ポイント
1. `Using` ステートメントの活用: `OpenFileDialog` はアンマネージドなリソースを消費します。`Using` を使うことで、処理が終われば即座にメモリを解放します。これが「メモリリークを防ぐ」エンジニアの作法です。
2. `Shared` 変数の活用: クラスをインスタンス化せずとも、どこからでもアクセスできる「記憶」として `_lastDirectory` を保持させています。
3. ガード節の考え方: `If ofd.ShowDialog() = DialogResult.OK` を用いることで、キャンセルされた場合を自然にスルーし、無駄なエラーを防いでいます。
—
3. 現場での呼び出し方（UIとの分離）
呼び出し側は非常にシンプルになります。フォーム側は「どのファイルが欲しいか」を指示するだけで、後はサービスにお任せです。
‘ ボタンクリックイベントなど
Private Sub btnSelectFile_Click(sender As Object, e As EventArgs) Handles btnSelectFile.Click
‘ テキストファイルを選択させる例
Dim selectedPath As String = FileDialogService.GetFilePath(“テキストファイル|.txt|すべてのファイル|.”)
‘ 空文字チェックを行う（これがユーザーのキャンセルをハンドルする術です）
If String.IsNullOrWhiteSpace(selectedPath) Then
Return
End If
‘ 安全に処理を開始
MessageBox.Show(“選択されたファイル: ” & selectedPath)
End Sub
—
4. 陥りやすいエラーと対策
初学者がよくやる「罠」を回避するためのチェックリストです。
- 「ファイルが存在しません」エラー: `OpenFileDialog` を使っている以上、選択されたファイルは存在することが保証されています。しかし、その後にファイルが削除される可能性はゼロではありません。必ず `File.Exists(path)` で確認してから開く癖をつけましょう。
- UIスレッドのブロック: ダイアログが表示されている間、アプリの操作は止まります。重い処理は `Task.Run` を使って別スレッドに逃がすのが定石ですが、まずはこのラッパーを完璧に使いこなすところから始めましょう。
- パスの正規化: `Path.GetFullPath()` を使い、冗長なパス（`C:\Folder\..\File.txt` など）を整える習慣をつけると、トラブルに強いコードになります。
—
最後に：エンジニアとしての一歩先へ
「動くコード」を書くことは、誰にでもできます。しかし、「壊れにくく、誰が読んでも意図が伝わり、再利用しやすいコード」を書くことこそが、プロフェッショナルへの道です。
今回紹介したラッパーは、いわば現場の「護身術」。これを土台にして、`FolderBrowserDialog` 版を作ってみたり、設定を `My.Settings` に保存してアプリ終了後も記憶を維持できるように拡張してみてください。
あなたの書くコードが、今日も誰かの業務を少しだけ楽にしますように。また次の技術トピックでお会いしましょう。
