【テクニカル・上級編】【中級者・実務】VB.NETとWPFでのDataGridチェックボックス一括選択:ヘッダー列への全選択・全解除連動実装 – Visual Basic (VB / VB.NET)解析バイブル

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

WPF DataGridにおける「一括選択」の真髄:大量データを制御するアーキテクチャ設計

業務アプリケーション、特に大規模な受注管理システムやマスターメンテナンスにおいて、ユーザーが直面する最大のストレスは「反復作業」である。数千、数万のレコードが存在する中で、一つ一つのチェックボックスをマウスでクリックさせる設計は、プロフェッショナルの仕事とは言えない。

DataGridのヘッダーに「全選択・全解除」のチェックボックスを配置するのは、もはや古典的な作法だ。しかし、これを単に「動く」レベルで実装するのと、数万件のデータに対してもUIスレッドを凍結させず、メモリ消費を最小限に抑えながら、堅牢なMVVMパターンで実装するのとでは、エンジニアとしての格が決定的に異なる。

本稿では、VB.NETを用いたWPF開発において、DataGridの一括選択機能を「極限のパフォーマンス」と「保守性」を両立させて実装する手法を詳解する。

1. 陥りがちな「素人」の設計:Code-behindへの依存

多くの開発者が、DataGridのイベント(`SelectionChanged` や `Click`)をViewのコードビハインドに記述し、そこでループを回して各行のプロパティを書き換えるという手法を取る。

' --- 避けるべきアンチパターン ---
Private Sub HeaderCheckBox_Click(sender As Object, e As RoutedEventArgs) Handles HeaderCheckBox.Click
    Dim isChecked As Boolean = DirectCast(sender, CheckBox).IsChecked.GetValueOrDefault()
    ' DataGridの全行をループして書き換える(UIスレッドを占有し、大規模データでフリーズする)
    For Each row As DataGridRow In MyDataGrid.Items
        Dim item = DirectCast(row.Item, MyModel)
        item.IsSelected = isChecked
    Next
End Sub

この設計は、以下の致命的な欠陥を抱えている。
1. 責務の混濁: ビジネスロジックがViewに漏れ出している。
2. スケーラビリティの欠如: 行数が増えるほど、UIスレッドのブロッキングが顕著になる。
3. テスト不能: ViewModelを介さないため、ユニットテストが不可能である。

我々が目指すべきは、「データの状態(State)」と「表示(View)」を完全に分離したMVVMアーキテクチャである。

2. 高速な一括制御を実現するViewModel設計

一括選択の肝は、ViewModelにおける「集約プロパティ」の管理にある。単に全てのプロパティを書き換えるのではなく、変更通知(`INotifyPropertyChanged`)の連鎖をいかに制御するかが、パフォーマンスの分水嶺となる。

Model: データの実体

まずは、各行のデータを保持するモデルだ。ここではメモリ効率を考慮し、不要なイベントハンドラを持たない純粋なデータオブジェクトとする。

''' <summary>
''' 各行のデータモデル
''' </summary>
Public Class OrderItem
    Implements INotifyPropertyChanged

    Private _isSelected As Boolean
    Private _orderId As String

    Public Property OrderId As String
        Get
            Return _orderId
        End Get
        Set(value As String)
            _orderId = value
        End Set
    End Property

    ''' <summary>
    ''' チェック状態。変更時に通知を行う。
    ''' </summary>
    Public Property IsSelected As Boolean
        Get
            Return _isSelected
        End Get
        Set(value As Boolean)
            If _isSelected <> value Then
                _isSelected = value
                OnPropertyChanged(NameOf(IsSelected))
            End If
        End Set
    End Property

    Public Event Property PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged

    Protected Sub OnPropertyChanged(propertyName As String)
        RaiseEvent PropertyChanged(propertyName, New PropertyChangedEventArgs(propertyName))
    End Sub
End Class

ViewModel: 制御の司令塔

ここがアーキテクチャの核心である。`IsAllSelected` プロパティを介して、全行の状態を制御する。

''' <summary>
''' DataGridを制御するメインViewModel
''' </summary>
Public Class OrderViewModel
    Implements INotifyPropertyChanged

    ' データのコレクション。大量データの場合は ObservableCollection を使用。
    Public Property OrderItems As New ObservableCollection(Of OrderItem)()

    Private _isAllSelected As Boolean
    ''' <summary>
    ''' ヘッダーのチェックボックスと連動する集約プロパティ
    ''' </summary>
    Public Property IsAllSelected As Boolean
        Get
            Return _isAllSelected
        End Get
        Set(value As Boolean)
            ' 無限ループを防ぐためのガード条件
            If _isAllSelected <> value Then
                _isAllSelected = value
                ' 全行の状態を一括更新
                ' ※大規模データの場合、ここでの更新がUIスレッドに負荷をかける。
                ' 実務では、Dispatcherを使用して優先度を調整するか、
                ' もしくは一括更新用の専用ロジックを検討する。
                For Each item In OrderItems
                    item.IsSelected = value
                Next
                OnPropertyChanged(NameOf(IsAllSelected))
            End If
        End Set
    End Property

    ' 各行のチェック状態が変わった際に、ヘッダーのチェック状態を再計算するロジック
    Public Sub RefreshAllSelectedStatus()
        Dim allChecked = OrderItems.All(Function(x) x.IsSelected)
        Dim anyChecked = OrderItems.Any(Function(x) x.IsSelected)

        ' ヘッダーの状態を更新(不一致の場合のみ)
        If _isAllSelected <> allChecked Then
            _isAllSelected = allChecked
            OnPropertyChanged(NameOf(IsAllSelected))
        End If
    End Sub

    Public Event Property PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged
    Protected Sub OnPropertyChanged(propertyName As String)
        RaiseEvent PropertyChanged(propertyName, New PropertyChangedEventArgs(propertyName))
    End Sub
End Class

3. XAMLによるモダンなUI構築:DataGridHeaderの拡張

次に、Viewの実装だ。DataGridのヘッダー部分にチェックボックスを埋め込むには、`DataGrid.ColumnHeaderTemplate` を利用するのが定石である。

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Advanced DataGrid Control" Height="450" Width="800">
    
    <Grid>
        <DataGrid ItemsSource="{Binding OrderItems}" 
                  AutoGenerateColumns="False" 
                  CanUserAddRows="False">
            <DataGrid.Columns>
                <!-- チェックボックス列:ヘッダーにカスタムテンプレートを適用 -->
                <DataGridTemplateColumn Width="Auto">
                    <DataGridTemplateColumn.Header>
                        <!-- ヘッダーのチェックボックス:ViewModelのIsAllSelectedと双方向バインディング -->
                        <CheckBox IsChecked="{Binding IsAllSelected, UpdateSourceTrigger=PropertyChanged}" 
                                  HorizontalAlignment="Center" VerticalAlignment="Center" />
                    </DataGridTemplateColumn.Header>
                    <DataGridTemplateColumn.CellTemplate>
                        <DataTemplate>
                            <!-- 行のチェックボックス:各アイテムのIsSelectedと双方向バインディング -->
                            <CheckBox IsChecked="{Binding IsSelected, UpdateSourceTrigger=PropertyChanged}" 
                                      HorizontalAlignment="Center" VerticalAlignment="Center" />
                        </DataTemplate>
                    </DataGridTemplateColumn.CellTemplate>
                </DataGridTemplateColumn>

                <!-- その他のデータ列 -->
                <DataGridTextColumn Header="注文ID" Binding="{Binding OrderId}" Width="*" />
            </DataGrid.Columns>
        </DataGrid>
    </Grid>
</Window>

4. 極限の知見:パフォーマンスとメモリの最適化

シニアエンジニアとして、コードを書いた後に必ず考えるべきは「エッジケースでの挙動」である。

1. 循環参照と通知の嵐(Notification Storm)

`IsAllSelected` の Setter 内で `item.IsSelected = value` を実行すると、各 `OrderItem` が `PropertyChanged` を発行し、それがさらに ViewModel の状態を揺さぶる。データが10万件ある場合、10万回の通知が UI スレッドを埋め尽くし、アプリケーションは応答不能(Not Responding)に陥る。

対策:

  • バッチ更新: 大量更新を行う際は、一時的に `IsSelected` の通知を抑制するか、`Dispatcher.BeginInvoke` を使用して `DispatcherPriority.Background` で処理をキューイングし、UI の描画更新を後回しにする。
  • 変更検知の最小化: Setter 内で `If _field <> value Then` のガードを必ず入れる。これは基本中の基本だが、忘れるとメモリリークとスタックオーバーフローの入り口になる。

2. メモリの断片化とオブジェクトのライフサイクル

大量の `OrderItem` オブジェクトを生成・破棄する場合、GC(Garbage Collector)の負荷が高まる。

  • オブジェクトの再利用: 可能であれば、データの入れ替え時に新しいインスタンスを生成するのではなく、既存のオブジェクトのプロパティを書き換える(Object Poolingの概念)ことで、GC の発生頻度を下げることが可能だ。
  • Weak Event Pattern: もし ViewModel と View の間でイベントを直接結ぶ必要がある場合は、必ず `WeakEventManager` を使用せよ。強参照によるメモリリークは、長時間稼働する業務システムにおいて致命傷となる。

3. レガシー環境との親和性

VBA や WinForms から WPF への移行プロジェクトでは、データソースが `DataTable` や `DataSet` であることが多い。この場合、WPF の強力なデータバインディングを活かすために、`ICollectionView` を活用してフィルタリングやソートを View 側で行うように設計を分離することが、システム全体の保守性を高める鍵となる。

結語

WPFにおける DataGrid の制御は、単なる UI 操作ではない。それは、データの整合性を保ちながら、いかにしてユーザーの計算資源(CPU/メモリ)を効率的に管理するかという、アーキテクチャの戦いである。

「動くコード」を書くのは初級者だ。「止まらない、重くならない、壊れないコード」を書くことこそが、我々プロフェッショナルに課せられた真の責務である。

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