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

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

結合の罠を排せ:WPF DataGridとDataTableにおける状態管理の極致

業務システムのフロントエンドにおいて、WPFの`DataGrid`とADO.NETの`DataTable`の組み合わせは、一見すると「最も手軽で強力な武器」に見える。しかし、その実態は、状態管理(State Management)という名の地雷原だ。

多くのエンジニアが、`DataTable`を単なる「データの入れ物」と誤解し、`DataGrid`にバインドした瞬間に、オブジェクトのライフサイクルとデータの整合性という、アーキテクチャの根幹に関わる制御を放棄してしまう。その結果、更新競合、予期せぬ例外、そしてメモリリークという代償を支払うことになる。

本稿では、中級者からシニアへと昇華するために避けては通れない、`DataTable`の内部状態(`DataRowState`)を掌握した、堅牢な一括編集・更新の実装術を伝授する。

1. 状態遷移の真実:`DataRowState`を制御せよ

`DataTable`を`DataGrid`にバインドした際、最も致命的なミスは、「いつ `AcceptChanges()` を呼び出すか」という判断を誤ることだ。

`DataTable`は、各行に対して`Added`, `Modified`, `Deleted`, `Unchanged` という状態を保持している。`DataGrid`上での編集は、この状態をリアルタイムに変化させる。

致命的なアンチパターン

開発者が「データが反映されたから」といって、更新処理の直前に `DataTable.AcceptChanges()` を呼び出す行為。これは、「変更履歴の抹消」を意味する。これを実行した瞬間、すべての行は `Unchanged` になり、`DataAdapter.Update()` を実行しても、データベースに対して「何も変更がない」と判断され、更新SQLが発行されなくなる。

正解のアーキテクチャ

`AcceptChanges()` は、データベースへの永続化が完全に成功した後にのみ、システムが状態を確定させるために呼び出すものである。

2. 堅牢な一括更新の実装:トランザクションと状態同期

業務システムにおける一括編集では、一部の行の更新に失敗した際、システム全体を整合性の取れた状態に戻す必要がある。ここでは、`DataAdapter`を用いた、例外に強い更新ロジックのテンプレートを示す。

“`vb.net
Imports System.Data
Imports System.Data.SqlClient

”’

”’ データアクセス層のコアロジック。
”’ 状態管理を徹底し、不整合を防ぐ。
”’

Public Class DataPersistenceService
Private ReadOnly _connectionString As String = “Your_Connection_String”

”’

”’ DataTableの変更内容をデータベースへ一括反映する。
”’

”’ DataGridにバインドされているDataTable Public Sub CommitBatchChanges(dt As DataTable)
‘ 1. 事前バリデーション:DataTableが空、あるいは接続不可な状態でないか
If dt Is Nothing Then Throw New ArgumentNullException(NameOf(dt))

Using conn As New SqlConnection(_connectionString)
conn.Open()
‘ トランザクションの開始:一括処理の原子性を保証
Using transaction As SqlTransaction = conn.BeginTransaction()
Try
Using adapter As New SqlDataAdapter()
‘ 2. CommandBuilderによる自動SQL生成(実務では手動SQL定義を推奨)
Dim builder As New SqlCommandBuilder(adapter)
adapter.SelectCommand = builder.GetSelectCommand()
adapter.InsertCommand = builder.GetInsertCommand()
adapter.UpdateCommand = builder.GetUpdateCommand()
adapter.DeleteCommand = builder.GetDeleteCommand()

‘ コマンドにトランザクションを紐付け
adapter.InsertCommand.Transaction = transaction
adapter.UpdateCommand.Transaction = transaction
adapter.DeleteCommand.Transaction = transaction

‘ 3. 更新処理の実行
‘ DataAdapter.Updateは、RowStateに基づいて適切なSQL(INSERT/UPDATE/DELETE)を内部で使い分ける
adapter.Update(dt)

‘ 4. 成功時のみ、DataTableの状態を確定させる
‘ これにより、RowStateがすべて Unchanged に戻る
dt.AcceptChanges()

‘ コミット
transaction.Commit()
End Using
Catch ex As Exception
‘ 5. 失敗時はロールバック。DBの状態を保護する。
transaction.Rollback()
‘ ロギング処理(実務では重要)
Throw New Exception(“一括更新中にエラーが発生しました。変更は破棄されました。”, ex)
End Try
End Using
End Using
End Sub
End Class

---

3. WPF DataGridにおける「行追加・削除」のトラブルシューティング

`DataGrid`で新しい行を追加したり、削除したりする際、UIスレッドとデータソースの同期が崩れ、`InvalidOperationException`(コレクションが変更されました)が発生することがある。

原因:列挙中のコレクション変更

`DataGrid`が描画のためにアイテムを列挙している最中に、コードビハインドから `DataTable.Rows.Remove()` を呼び出すと、この例外が投げられる。

解決策:Dispatcherによるスレッド制御とバッチ処理

大量の行操作を行う場合は、UIの更新負荷を抑えるために `BeginLoadData()` と `EndLoadData()` を活用し、さらに `Dispatcher` を介して操作のタイミングを制御する。

vb.net
”’

”’ DataGrid操作の安全な実行
”’

Public Sub SafeDeleteRows(dt As DataTable, rowsToDelete As List(Of DataRow))
‘ UIスレッドへの負荷を考慮し、Dispatcherを介して実行
Application.Current.Dispatcher.Invoke(Sub()
Try
‘ DataTableのイベント(RowChanged等)を一時停止し、パフォーマンスを最適化
dt.BeginLoadData()

‘ 削除は逆順に行う(インデックスのズレを防ぐ定石)
Dim sortedRows = rowsToDelete.OrderByDescending(Function(r) r.RowError).ToList() ‘ 例として適当な順序
‘ 実際には、元のインデックスに基づいた降順ソートが必須

For Each row In sortedRows
If dt.Rows.Contains(row) Then
row.Delete() ‘ 直接Removeするのではなく、Deleteを呼んでRowStateをDeletedにする
End If
Next
Finally
‘ 必ずEndLoadDataを呼び出し、イベントを再開させる
dt.EndLoadData()
End Try
End Sub)
End Sub
“`

4. メモリ最適化とリソース管理の極意

大規模な業務システムでは、`DataTable`に数万件のデータをロードすることがある。このとき、`DataGrid`の仮想化(Virtualization)が効いていても、メモリ消費量は無視できない。

オブジェクトの明示的解放

`DataTable`や`DataSet`は、それ自体が大量のメモリを保持する。特に、`DataAdapter`や`SqlConnection`などの `IDisposable` を実装したオブジェクトは、必ず `Using` ブロックで囲むか、明示的に `Dispose()` を呼び出さなければならない。

Win32 APIの視点:UIのハングを防ぐ

`DataGrid`の大量更新によりUIがフリーズする場合、それはWPFのメッセージループが過剰な描画要求(Layout Update)で埋め尽くされている証拠だ。
実務レベルでは、`DataGrid.UpdateLayout()` を頻繁に呼び出すのではなく、データの更新が終わった後に一括して描画を促す設計にする。

また、レガシーな環境との連携で、外部プロセスから制御が必要な場合は、`SendMessage` 等の Windows API を用いて強制的にフォーカスを移動させる手法もあるが、WPFにおいては `FocusManager` を用いたプロパティ制御が、マネージドな作法として正しい。

結論:アーキテクトの視点

`DataGrid`と`DataTable`の連携において、重要となるのは「データの状態(State)に対する敬意」だ。

1. `DataRowState` を理解せよ。 `AcceptChanges` は勝手に呼ぶな。
2. 原子性を確保せよ。 `SqlTransaction` は必須である。
3. 例外を恐れず、制御せよ。 `BeginLoadData` でパフォーマンスを確保し、`Try-Catch-Rollback` で整合性を守れ。

これらを遵守することで、あなたの構築するシステムは、単なる「動くツール」から、プロフェッショナルが信頼を寄せる「堅牢な基盤」へと昇華する。

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