【入門編】【中級者・実務】VB.NETとWPFでのDataGrid一括編集・行追加・行削除:DataTableバインディング時のトラブルシューティング – Visual Basic (VB / VB.NET)解析バイブル

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

WPFとDataTableの「不協和音」を解消する:DataGrid一括操作の極意

こんにちは。開発の現場へようこそ。
ExcelマクロやVBAの世界から一歩踏み出し、Visual Basic (VB.NET) と WPF を使った本格的なデスクトップアプリ開発に挑戦している皆さん、素晴らしい一歩を踏み出しましたね。

これまで「セルの中身を直接書き換える」という感覚でプログラミングをしてきた方にとって、WPFの DataGrid と DataTable の組み合わせは、少し「魔法」のように感じられるかもしれません。

「コードではデータを入れたはずなのに、画面が変わらない」
「行を削除した瞬間に、アプリが謎のエラーで落ちた」
「更新ボタンを押すと、なぜか変更が保存されない……」

これらは、決してあなたの才能がないから起きるわけではありません。「データの持ち方(Source)」と「見た目(View)」のライフサイクル、つまり「データの同期」という概念の境界線で、少しだけ迷子になっているだけなのです。

今日は、実務で必ずと言っていいほど直面する「DataGridとDataTableの同期トラブル」を、根本から解決するテクニックを伝授します。ここをクリアすれば、あなたの作る業務システムは格段に堅牢になりますよ。

1. 概念の整理:DataGridは「鏡」に過ぎない

まず、最も重要なマインドセットをお伝えします。

WPFのDataGridにおいて、DataGrid自体はデータを保持していません。
DataGridは、背後にある `DataTable` という「データの塊」を映し出す 「鏡」 なのです。

【データの流れのイメージ】
[ DataTable (真実のデータ) ]  <--- 魂
      ↓ (Binding)
[ DataView (フィルタや並び替えの窓口) ] <--- フィルター
      ↓ (Visual)
[ DataGrid (ユーザーが見る画面) ] <--- 鏡

初心者が陥る最大の罠は、「DataGridの行(Row)を直接操作しようとすること」 です。
行を追加したいならDataGridに命令するのではなく、DataTableに「新しいデータ(DataRow)を追加して」と命じなければなりません。鏡に向かって「顔を赤くしろ」と言っても無理なのと同じですね。

2. 実践:堅牢なDataGridの実装サンプル

それでは、実際に「行の追加」「削除」「一括更新」を安全に行うためのコードを見ていきましょう。

【XAML】UIの設計図

まずは、見た目を作ります。`AutoGenerateColumns=”False”` を指定して、列を明示的に定義するのがプロの作法です。これにより、意図しない列が表示されるトラブルを防げます。

<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="業務データ管理システム" Height="450" Width="600">
    <Grid Margin="10">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>

        <!-- 操作ボタンエリア -->
        <StackPanel Orientation="Horizontal" Grid.Row="0" Margin="0,0,0,10">
            <Button Content="行追加" Width="80" Margin="5" Click="BtnAdd_Click"/>
            <Button Content="選択行削除" Width="80" Margin="5" Click="BtnDelete_Click"/>
            <Button Content="一括保存" Width="80" Margin="5" Click="BtnSave_Click" Background="LightBlue"/>
        </StackPanel>

        <!-- データ表示エリア -->
        <DataGrid x:Name="dgMain" Grid.Row="1" 
                  AutoGenerateColumns="False" 
                  CanUserAddRows="False" 
                  SelectionMode="Single">
            <DataGrid.Columns>
                <DataGridTextColumn Header="ID" Binding="{Binding ID}" IsReadOnly="True" Width="50"/>
                <DataGridTextColumn Header="商品名" Binding="{Binding ProductName}" Width="*"/>
                <DataGridTextColumn Header="単価" Binding="{Binding Price}" Width="100"/>
            </DataGrid.Columns>
        </DataGrid>

        <!-- ステータス表示 -->
        <StatusBar Grid.Row="2">
            <TextBlock x:Name="txtStatus" Text="準備完了"/>
        </StatusBar>
    </Grid>
</Window>

【VB.NET】ロジックの核心

次に、バックエンドの処理です。ここが「魔法」を制御する部分です。

Imports System.Data

Class MainWindow
    ' データの本体となるDataTableを保持
    Private _dataTable As DataTable

    Public Sub New()
        InitializeComponent()
        InitializeData()
    End Sub

    ''' <summary>
    ''' DataTableの初期化(スキーマの定義)
    ''' </summary>
    Private Sub InitializeData()
        ' 1. DataTableの作成
        _dataTable = New DataTable("Products")

        ' 2. 列(カラム)の定義。型を厳密に指定するのがコツです
        _dataTable.Columns.Add("ID", GetType(Integer))
        _dataTable.Columns.Add("ProductName", GetType(String))
        _dataTable.Columns.Add("Price", GetType(Integer))

        ' 3. 制約の設定(主キーを設定しておくと、後の更新が楽になります)
        _dataTable.PrimaryKey = New DataColumn() {_dataTable.Columns("ID")}

        ' 4. DataGridへのバインディング
        ' DataTableを直接渡すと、編集状態の同期がスムーズに行われます
        dgMain.ItemsSource = _dataTable.DefaultView
    End Sub

    ''' <summary>
    ''' 行の追加:DataTableに直接Rowを追加する
    ''' </summary>
    Private Sub BtnAdd_Click(sender As Object, e As RoutedEventArgs)
        ' 新しい行を作成
        Dim newRow As DataRow = _dataTable.NewRow()
        
        ' デフォルト値の設定(IDは仮で自動採番のシミュレーション)
        newRow("ID") = If(_dataTable.Rows.Count > 0, _dataTable.Rows(_dataTable.Rows.Count - 1)("ID") + 1, 1)
        newRow("ProductName") = "新規商品"
        newRow("Price") = 0

        ' DataTableに追加することで、DataGridに自動的に反映される
        _dataTable.Rows.Add(newRow)
        txtStatus.Text = "行を追加しました。"
    End Sub

    ''' <summary>
    ''' 行の削除:選択されている行の「データ」を削除する
    ''' </summary>
    Private Sub BtnDelete_Click(sender As Object, e As RoutedEventArgs)
        ' DataGridで選択されている行を取得
        Dim selectedRow As DataRowView = TryCast(dgMain.SelectedItem, DataRowView)

        If selectedRow IsNot Nothing Then
            ' 重要:DataGridのRowを消すのではなく、DataRowを消す!
            selectedRow.Row.Delete()
            txtStatus.Text = "選択された行を削除しました。"
        Else
            MessageBox.Show("削除する行を選択してください。")
        End If
    End Sub

    ''' <summary>
    ''' 一括保存:変更された行だけを抽出して処理する(概念的な実装)
    ''' </summary>
    Private Sub BtnSave_Click(sender As Object, e As RoutedEventArgs)
        ' DataGridの編集を確定させるために、フォーカスを外す処理が必要な場合があります
        dgMain.CommitEdit()

        Try
            ' DataTableの中には「何が変更されたか」という情報(RowState)が蓄積されています
            ' 例:Added(追加), Modified(変更), Deleted(削除)
            
            ' ここでは、変更があった行だけをループして確認する例を示します
            For Each row As DataRow In _dataTable.GetChanges().Rows
                Select Case row.RowState
                    Case DataRowState.Added
                        Debug.WriteLine($"追加対象: {row("ProductName")}")
                    Case DataRowState.Modified
                        Debug.WriteLine($"変更対象: {row("ProductName")}")
                    Case DataRowState.Deleted
                        Debug.WriteLine($"削除対象")
                End Select
            Next

            ' --- 本来はここでDBへSQLを発行します ---
            
            ' 最後に「変更を確定」させる。これを忘れると、次回の保存でまた全部送られてしまいます。
            _dataTable.AcceptChanges()
            
            txtStatus.Text = "すべての変更を保存しました。"
            MessageBox.Show("保存が完了しました。")

        Catch ex As Exception
            MessageBox.Show($"エラーが発生しました: {ex.Message}")
        End Try
    End Sub
End Class

3. トラブルシューティング:なぜエラーは起きるのか?

現場でよく遭遇する「3大トラブル」とその回避策を整理しておきましょう。

① 「行を消した瞬間に IndexOutOfRangeException が出る」

原因: `For Each` で `DataTable.Rows` を回している最中に、その中の行を `RemoveAt` などで消している場合に起こります。
対策:

  • 行を削除する場合は、`DataRow.Delete()` メソッドを使用してください。これは「削除フラグを立てる」だけで、コレクションの構造を即座に変えないため、ループ中のエラーを防げます。
  • 最後に `AcceptChanges()` を呼ぶことで、まとめて整理されます。

② 「編集したはずなのに、保存ボタンを押すと元の値に戻る」

原因: `AcceptChanges()` を呼ぶタイミングが早すぎます。
対策:
`AcceptChanges()` は、「DBへの保存が完全に成功した後」にだけ呼んでください。もし保存の途中でエラーが出た場合、`AcceptChanges` を呼んでいなければ、DataTable内の `RowState` は「変更あり」のままなので、ユーザーはもう一度「保存」を試みることができます。

③ 「DataGridのセルから抜けないと、データが更新されない」

原因: DataGridの編集モード(セル入力中)は、そのセルからフォーカスが外れる(Commitされる)まで、DataTableへの書き込みが完了していません。
対策:
保存処理の冒頭で、必ず `dgMain.CommitEdit()` を呼び出してください。これで、現在入力中の内容を強制的にDataTableへと同期させることができます。

まとめ:マスターへの道

いかがでしたか?
WPFでの開発は、最初は「直接操作できないもどかしさ」を感じるかもしれません。しかし、「データ(DataTable)を操作すれば、UI(DataGrid)は勝手についてくる」 という考え方にシフトできたとき、あなたの開発スピードとコードの品質は劇的に向上します。

1. DataGridではなく、DataTableを操作する。
2. RowState(追加・変更・削除)を意識する。
3. AcceptChanges() は、成功の証として最後に呼ぶ。

この3点を守るだけで、業務システムの安定性は見違えるほど良くなります。
一歩ずつ、着実に。プロフェッショナルなエンジニアへの道を歩んでいきましょう。応援していますよ!

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