【入門編】【中級者・実務】WPFのDispatcherを活用したバックグラウンド処理中のUIフリーズ防止とスレッド間通信 – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク

こんにちは。今日は、VB.NETでモダンなデスクトップアプリを構築する上で、誰もが一度はぶつかる「壁」についてお話ししましょう。

それは、「重い処理をさせると、画面が固まって(フリーズして)操作できなくなる」という問題です。

VBAなどのシングルスレッド環境からステップアップした方が最初によく陥る罠ですが、ここを乗り越えれば、あなたの作るアプリは「素人のツール」から「プロのソフトウェア」へと進化します。

今回のテーマは、WPFにおけるDispatcher(ディスパッチャー)を活用したスレッド間通信です。難しそうな名前ですが、本質はとてもシンプル。一緒に紐解いていきましょう。

1. なぜUIはフリーズするのか?「料理人と助手」の物語

まず、WPFの内部で何が起きているのかを、キッチンに例えて説明します。

WPFアプリには、「UIスレッド」というたった一人の「メイン料理人」がいます。この料理人の仕事は、ボタンの描画、マウス操作への反応、プログレスバーのアニメーションなど、ユーザーに見える部分をすべて管理することです。

ところが、この料理人は非常に真面目です。もしあなたが「100万件のデータを集計せよ」という命令(重い処理)を出すと、彼はその集計が終わるまで、他のことは一切しなくなります。

  • ボタンが押されても無視
  • 画面の再描画もしない
  • Windowsからは「応答なし」と判定される

これが「UIフリーズ」の正体です。

解決策:助手を雇う(バックグラウンド処理)

そこで、「助手(バックグラウンドスレッド)」を雇います。
「重い集計作業は助手にお願いし、メイン料理人は引き続き、お客さま(ユーザー)への対応に専念してもらう」。これがマルチスレッド処理の基本です。

しかし、ここで最大の問題が発生します。

「WPFのルールとして、UI(ボタンやテキストボックス)を触れるのは、メイン料理人(UIスレッド)だけである」

助手が「集計が終わったので、結果を画面に表示しますね!」と直接ラベルを書き換えようとすると、WPFは「権限がない!」と怒って例外(InvalidOperationException)を投げ、アプリを強制終了させます。

この「助手から料理人への伝言板」の役割を果たすのが、今回主役となる `Dispatcher` なのです。

2. 実装してみよう:Dispatcherによる安全なUI更新

それでは、具体的にコードを見ていきましょう。
「ボタンを押すと、5秒かけて重い処理を行い、その進捗をプログレスバーに反映させる」という実装です。

XAML(見た目)

まずはシンプルな画面を用意します。

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Dispatcherマスターへの道" Height="200" Width="400">
    <StackPanel Margin="20" VerticalAlignment="Center">
        <TextBlock x:Name="txtStatus" Text="待機中..." Margin="0,0,0,10" HorizontalAlignment="Center"/>
        <ProgressBar x:Name="pbProgress" Height="20" Minimum="0" Maximum="100" Margin="0,0,0,20"/>
        <Button x:Name="btnStart" Content="重い処理を開始する" Click="btnStart_Click" Width="150" Height="30"/>
    </StackPanel>
</Window>

VB.NET(ロジック)

ここが本番です。`Async/Await` と `Dispatcher` を組み合わせた現代的な書き方で実装します。

Imports System.Threading
Imports System.Threading.Tasks

Class MainWindow
    ''' <summary>
    ''' ボタンクリックイベント(UIスレッドで動作)
    ''' </summary>
    Private Async Sub btnStart_Click(sender As Object, e As RoutedEventArgs)
        ' 1. UIの準備
        btnStart.IsEnabled = False ' 二重押し防止
        txtStatus.Text = "処理中..."
        pbProgress.Value = 0

        ' 2. 重い処理を「助手(バックグラウンドスレッド)」に依頼する
        ' Task.Runを使うことで、ここから先の処理は別スレッドで動きます
        Await Task.Run(Sub()
                           ExecuteHeavyProcess()
                       End Sub)

        ' 3. すべて終わったらUIを元に戻す(ここはAwaitのおかげでUIスレッドに戻っている)
        txtStatus.Text = "完了しました!"
        btnStart.IsEnabled = True
    End Sub

    ''' <summary>
    ''' 重い処理の本体(バックグラウンドスレッドで動作)
    ''' </summary>
    Private Sub ExecuteHeavyProcess()
        ' 擬似的な重い処理(10ステップのループ)
        For i As Integer = 1 To 10
            ' --- ここで擬似的な負荷をかける(1秒待機) ---
            Thread.Sleep(500)

            ' 進捗率を計算
            Dim percent As Integer = i * 10

            ' 【重要】ここからUIを更新したいが、ここは助手(別スレッド)の領域。
            ' 直接 pbProgress.Value = percent と書くとエラーになります。
            ' そこで、Dispatcher(伝言板)を通じてメイン料理人に依頼します。
            
            Me.Dispatcher.Invoke(Sub()
                                    ' この中だけは「UIスレッド」として実行される
                                    pbProgress.Value = percent
                                    txtStatus.Text = $"処理中... ({percent}%)"
                                End Sub)
            ' -------------------------------------------------------
        Next
    End Sub
End Class

3. プロの視点:ここが「極限の知見」である

上記のコードで正しく動作しますが、実務でさらに上のレベルを目指すなら、以下の3点を意識してください。

① `Invoke` と `BeginInvoke` の使い分け

コード内で `Dispatcher.Invoke` を使いましたが、実は `BeginInvoke` というメソッドもあります。

  • `Invoke` (同期処理): 料理人がその作業を終えるまで、助手はその場で待機します。
  • `BeginInvoke` (非同期処理): 料理人に「これやっといて!」とメモを渡して、助手はすぐに次の作業に戻ります。

結論: UI更新で助手が待機する必要がない場合は、`BeginInvoke` を使う方がパフォーマンスが向上し、デッドロック(お互い待ち状態になる現象)を防げます。

② `IProgress(Of T)` というエレガントな選択肢

`Dispatcher` を直接呼ぶのは簡単ですが、ロジックの中にUI操作が混ざるため、コードが汚くなりがちです。
プロの現場では、`.NET` が提供している `IProgress(Of T)` インターフェースを使います。これにより、「処理ロジック」と「UI更新」を完全に切り離すことができます。

③ ライフサイクルの罠

バックグラウンド処理中にユーザーがウィンドウを閉じた場合、`Dispatcher` が既に破棄されていることがあります。その状態で `Invoke` を呼ぶと、アプリがクラッシュします。
実務では `If Me.Dispatcher.CheckAccess() Then` や、`CancellationToken` を使って、処理を安全にキャンセルする仕組みを組み込むのが鉄則です。

まとめ:ここをクリアすれば基本はバッチリです!

今回のポイントを整理しましょう。

1. UIスレッド(メイン料理人)を長時間拘束すると、アプリはフリーズする。
2. 重い処理は `Task.Run`(助手) に任せる。
3. 助手からUIを操作したいときは、`Dispatcher`(伝言板) 経由で依頼する。
4. `Invoke` は待つ、`BeginInvoke` は待たない。

「画面が固まる」という現象は、ユーザーにとって最もストレスフルな体験です。それを解決できるエンジニアは、ユーザーへの思いやりを持っているエンジニアだと言えます。

この `Dispatcher` の概念をマスターすれば、あなたはもう「マクロの延長線上の人」ではありません。Windowsアプリケーションを自在に操る、真のVB.NETエンジニアへの道を歩み始めています。

自信を持って、どんどんモダンなUIに挑戦してくださいね!

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