VB.NETの「BackgroundWorker」完全攻略：UIを凍らせないための極意
こんにちは。現場で「画面がフリーズして動かなくなった」という悪夢に悩まされたことはありませんか？
VB.NETにおけるWindows Forms開発で、重い処理をボタンクリックイベントの中に直接書いてしまうのは、「車の運転中にエンジンの整備をしようとする」のと同じくらい危険な行為です。
今回は、レガシーなシステムでも現役バリバリの「BackgroundWorker」を使いこなし、UIをサクサク保ちながら裏で仕事を完遂させるための「安全な設計術」を伝授します。
—
1. なぜ「BackgroundWorker」なのか？
現代の .NET では `async/await` が主流ですが、既存の巨大なプロジェクトや、保守が求められるレガシーコードでは、あえて `BackgroundWorker` を使うべき場面があります。
最大の理由は「スレッドの安全性（スレッドセーフ）」が保証されているからです。
本来、別スレッドからUI（ボタンやテキストボックス）を直接操作するとエラーになりますが、`BackgroundWorker` はこの複雑な橋渡しを自動でやってくれます。
—
2. 実装の設計図：3つの鉄則
安全に実装するための「3つの約束」を頭に入れてください。
1. DoWork（裏方）でUIを触るな: 計算やファイル操作はここ。UIのプロパティを直接変えてはいけません。
2. ReportProgress（進捗報告）を正しく使え: UIの更新は必ずこれ経由で行います。
3. CancellationPending（中断要求）を監視せよ: ユーザーが「キャンセル」を押したか、常にループ内でチェックします。
—
3. 実践コード：安全な非同期処理テンプレート
以下のコードは、長時間の処理を安全に行うための雛形です。そのまま現場のコードに組み込めるように設計しています。
‘ フォームのロード時などにWorkerの設定を行う想定
Public Class Form1
‘ 1. BackgroundWorkerのインスタンス化
Private WithEvents worker As New System.ComponentModel.BackgroundWorker()
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
‘ 進捗報告を有効にする（重要！）
worker.WorkerReportsProgress = True
‘ キャンセル機能を有効にする
worker.WorkerSupportsCancellation = True
End Sub
‘ 【処理開始ボタン】
Private Sub btnStart_Click(sender As Object, e As EventArgs) Handles btnStart.Click
btnStart.Enabled = False
btnCancel.Enabled = True
worker.RunWorkerAsync() ‘ ここで別スレッドが動き出す
End Sub
‘ 【裏方の処理】
Private Sub worker_DoWork(sender As Object, e As System.ComponentModel.DoWorkEventArgs) Handles worker.DoWork
For i As Integer = 1 To 100
‘ 2. キャンセル要求が来ているかチェック
If worker.CancellationPending Then
e.Cancel = True
Exit For
End If
‘ 重い処理のシミュレーション（100ミリ秒待機）
System.Threading.Thread.Sleep(100)
‘ 3. UIスレッドへ進捗を報告
worker.ReportProgress(i, $”進捗状況: {i}% 完了…”)
Next
End Sub
‘ 【進捗報告イベント】（UIスレッドで安全に実行される）
Private Sub worker_ProgressChanged(sender As Object, e As System.ComponentModel.ProgressChangedEventArgs) Handles worker.ProgressChanged
ProgressBar1.Value = e.ProgressPercentage
LabelStatus.Text = e.UserState.ToString()
End Sub
‘ 【処理完了イベント】
Private Sub worker_RunWorkerCompleted(sender As Object, e As System.ComponentModel.RunWorkerCompletedEventArgs) Handles worker.RunWorkerCompleted
If e.Cancelled Then
LabelStatus.Text = “キャンセルされました。”
Else
LabelStatus.Text = “処理が完了しました！”
End If
btnStart.Enabled = True
btnCancel.Enabled = False
End Sub
‘ 【キャンセルボタン】
Private Sub btnCancel_Click(sender As Object, e As EventArgs) Handles btnCancel.Click
worker.CancelAsync()
End Sub
End Class
—
4. なぜこの書き方なのか？（エンジニアの視点）
なぜ `ReportProgress` を使うのか？
VB.NETのWindows Formsは、UIを作成したスレッド以外からの操作を受け付けないという強い制約（シングルスレッド・アパートメント）があります。`ReportProgress` を使うと、内部で `Control.Invoke` が自動的に呼ばれ、メインスレッドへの「お願い」が安全に完了します。これを使わずに直接 `Label1.Text = …` と書くと、ランタイムエラーでアプリが落ちます。
なぜ `CancellationPending` を監視するのか？
`worker.CancelAsync()` を呼んだからといって、裏で動いている処理が即座に止まるわけではありません。 「キャンセルする準備をしてね」というフラグが立つだけです。処理のループの中に `If worker.CancellationPending Then …` を挟むことで、初めて「安全な停止」が可能になるのです。
—
5. まとめ：ここをクリアすれば「中級者」
今回のコードのポイントをまとめます。
- `WorkerReportsProgress = True` を忘れない。
- 重い処理の中には必ず中断チェックを入れる。
- UIの更新はすべて `ProgressChanged` に追い出す。
このパターンさえ身につけてしまえば、どれほど重いファイル処理やデータベースアクセスが発生しても、あなたのアプリはフリーズすることなく、ユーザーに優しく進捗を伝え続けられます。
「マクロの記録」からの脱却は、こうした「非同期処理との付き合い方」を理解したときから始まります。ぜひ、あなたのプロジェクトで試してみてください。エラーが出たら、それは成長のチャンスですよ。応援しています！
