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