【実務・中級編】【中級者・実務】VB.NETのWPFで実現する複数画面(マルチウィンドウ)管理:親画面と子画面間のデータ授受とライフサイクル制御 – Visual Basic (VB / VB.NET)解析バイブル

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

WPF/VB.NETにおけるマルチウィンドウ制御の極意:疎結合な設計で「バグの出ない」業務アプリを構築する

業務アプリケーションの開発において、避けて通れないのが「複数画面の制御」だ。
設定画面をモーダルで表示し、ユーザーの入力を待機する。あるいは、サブツールとしてモードレスな監視ウィンドウを立ち上げる。

しかし、多くの開発者がここで致命的な設計ミスを犯す。
「子画面から親画面のコントロールを直接操作する」「グローバル変数や共有モジュールにデータを放り込む」「画面を閉じたはずなのにメモリが解放されない」――。

これらはすべて、オブジェクトのライフサイクルと依存関係に対する理解が欠如していることに起因する。
本稿では、プロフェッショナルとして、保守性が高く、堅牢なマルチウィンドウ管理を実現するための「イベント駆動型設計パターン」を伝授する。

1. なぜ「直接参照」は悪なのか?

まず、初心者がやりがちな「アンチパターン」を明確にしておこう。

アンチパターン:強結合な設計

子画面(SettingsWindow)の中で、以下のようなコードを書くケースだ。

' 【絶対NG】子画面から親のコントロールを直接叩く
DirectCast(Application.Current.MainWindow, MainWindow).txtUserName.Text = "New Name"

このコードがなぜ「プロの仕事」ではないのか。理由は3つある。

1. 再利用性の喪失: この子画面は `MainWindow` でしか使えなくなる。別の画面から呼び出そうとした瞬間にランタイムエラーが発生する。
2. 保守性の低下: 親画面のUI構造(コントロール名や構成)を変更しただけで、子画面のコードまで修正が必要になる。
3. テストの困難さ: 画面同士が密接に絡み合っているため、単体での動作検証が不可能になる。

設計の鉄則は、「子は親を知ってはならない」。
子は「何かが起きた(Event)」ことだけを通知し、それをどう処理するかは親(呼び出し元)の責任とする。これが疎結合(Loose Coupling)の概念だ。

2. 実践:イベント経由のデータ授受パターン

では、どのようにデータを渡すべきか。
「カスタムイベント」と「データ保持用のクラス(DTO)」を用いるのが、最もクリーンな解決策だ。

以下の実装例を見てほしい。設定画面(子)で入力したデータを、メイン画面(親)に安全に渡すシナリオだ。

Step 1: データを運搬するモデルの定義

まず、画面間でやり取りするデータの構造を定義する。これはUIに依存しない純粋なクラスであるべきだ。

''' <summary>
''' 設定情報を保持するためのデータ転送オブジェクト (DTO)
''' </summary>
Public Class UserSettings
    Public Property UserName As String
    Public Property UpdateTimestamp As DateTime
End Class

Step 2: 子画面(SettingsWindow)の実装

子画面は、自身のUIの状態を保持し、確定したタイミングでイベントを発火させる。

SettingsWindow.xaml (抜粋)

<StackPanel Margin="20">
    <TextBlock Text="ユーザー名を入力してください:" />
    <TextBox x:Name="txtName" Margin="0,5,0,15" />
    <Button Content="保存" Click="BtnSave_Click" Width="80" HorizontalAlignment="Right"/>
</StackPanel>

SettingsWindow.xaml.vb

Public Class SettingsWindow
    ''' <summary>
    ''' 設定が確定した際に発生するカスタムイベント
    ''' </summary>
    Public Event SettingsConfirmed(sender As Object, e As UserSettings)

    ''' <summary>
    ''' 保存ボタン押下時の処理
    ''' </summary>
    Private Sub BtnSave_Click(sender As Object, e As RoutedEventArgs)
        ' 1. 入力値のバリデーション(実務では必須)
        If String.IsNullOrWhiteSpace(txtName.Text) Then
            MessageBox.Show("名前を入力してください。", "警告", MessageBoxButton.OK, MessageBoxImage.Warning)
            Return
        End If

        ' 2. データのパッケージング
        Dim updatedSettings As New UserSettings With {
            .UserName = txtName.Text,
            .UpdateTimestamp = DateTime.Now
        }

        ' 3. イベントの発火(親への通知)
        ' ここで親のコントロールを操作せず、単に「データができた」と伝えるだけ
        RaiseEvent SettingsConfirmed(Me, updatedSettings)

        ' 4. ダイアログを閉じる(DialogResultをTrueにする)
        Me.DialogResult = True
    End Sub
End Class

Step 3: 親画面(MainWindow)での管理

親画面は、子画面のインスタンスを生成し、イベントを「購読(Subscribe)」する。

MainWindow.xaml.vb

Public Class MainWindow
    ''' <summary>
    ''' 設定画面を開く
    ''' </summary>
    Private Sub BtnOpenSettings_Click(sender As Object, e As RoutedEventArgs) Handles BtnOpenSettings.Click
        ' 1. 子画面のインスタンス化
        Dim settingsWin As New SettingsWindow()

        ' 2. イベントハンドラの登録 (ここが重要!)
        ' 子画面がイベントを投げた時に、こちらのメソッドを呼ぶように紐付ける
        AddHandler settingsWin.SettingsConfirmed, AddressOf OnSettingsConfirmed

        ' 3. モーダル表示
        ' ShowDialogは、閉じられるまで呼び出し元をブロックする
        Dim result As Boolean = settingsWin.ShowDialog()

        ' 4. 後処理
        ' イベントハンドラを解除(メモリリーク防止の作法)
        RemoveHandler settingsWin.SettingsConfirmed, AddressOf OnSettingsConfirmed

        If result = True Then
            ' 成功時の処理はイベント内で完結しているが、
            ' ここでは「ダイアログが正常に閉じられた」ことに対するロジックを書ける
            lblStatus.Content = $"最終更新: {DateTime.Now:HH:mm:ss}"
        End If
    End Function

    ''' <summary>
    ''' 子画面からの通知を受け取るハンドラ
    ''' </summary>
    Private Sub OnSettingsConfirmed(sender As Object, e As UserSettings)
        ' 親画面のコントロール操作は、親の責任で行う
        txtDisplayUserName.Text = e.UserName
        lblLastUpdate.Content = $"データ受信時刻: {e.UpdateTimestamp:yyyy/MM/dd HH:mm:ss}"
        
        ' ここでデータベースへの保存処理などを呼び出すのが理想的
        ' SaveToDatabase(e) 
    End Sub
End Class

3. プロフェッショナルのための「ライフサイクル制御」の注意点

コードを書くだけでは不十分だ。実務でバグを誘発する「落とし穴」を回避するための知見を共有する。

① メモリリークの罠:イベントの解除

上記のコードで `RemoveHandler` を記述した理由は、イベントによる参照の残留を防ぐためだ。
VB.NET(および .NET 全般)において、オブジェクト間のイベント接続は「強い参照」となる。親が子のイベントを購読したまま、子が破棄されずにメモリ上に残り続けると、ガベージコレクション(GC)が適切に機能せず、メモリリークを引き起こす。
特に、モードレスウィンドウ(`Show()` で開く画面)を多用する場合は、`Closed` イベントを利用して確実にハンドラを解除する設計にせよ。

② モーダル (`ShowDialog`) と モードレス (`Show`) の使い分け

  • モーダル (`ShowDialog`):
  • 用途: 設定変更、確認ダイアログ、必須入力フォーム。
  • 利点: 処理が同期的に進むため、コードが追いやすい。ユーザーの操作を制限できる。
  • 注意: ユーザーが「作業を中断させられた」と感じるUIにならないよう、必要最小限に留めること。
  • モードレス (`Show`):
  • 用途: ログ監視ツール、検索パネル、サブツール。
  • 利点: メイン画面と並行して操作できる。
  • 注意: ライフサイクル管理が複雑になる。親画面が閉じられた時に、モードレスウィンドウも同時に閉じるよう `Owner` プロパティを設定すること。
Dim subWin As New SubWindow()
    subWin.Owner = Me ' 親をオーナーに設定することで、親と共に消滅させる
    subWin.Show()

③ I/O処理(ファイル・DB)の責務分離

子画面の `BtnSave_Click` の中で、直接 `SqlConnection` を開いたり、`File.WriteAllText` を実行したりしてはならない。
UI要素(Window)はあくまで「ユーザーとのインターフェース」だ。データの永続化は、Service層やRepository層といった、UIとは切り離されたロジック層で行うべきである。これにより、将来的に「Web API経由での保存」に変更が必要になった際、UIコードを一切汚さずに済む。

まとめ:堅牢な設計へのロードマップ

1. 親と子は疎結合に: 子から親を直接触らせない。
2. イベントを活用せよ: 「何かが起きた」という事実だけを通知する。
3. DTOでデータを運べ: UIに依存しない純粋なクラスでデータを渡す。
4. ライフサイクルを管理せよ: `Owner` の設定と `RemoveHandler` を忘れない。

これらの原則を守ることで、あなたの作成する業務アプリケーションは、単なる「動くツール」から、変化に強く、チームが安心してメンテナンスできる「プロフェッショナルな製品」へと昇華する。

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