DataTable.GetChangesとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataTable.GetChanges メソッド ()

前回 DataTable を読み取るか、AcceptChanges を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function GetChanges As
 DataTable

Visual Basic (使用法)

Dim instance As DataTable
Dim returnValue As DataTable

returnValue = instance.GetChanges

public DataTable GetChanges ()

C++

public:
DataTable^ GetChanges ()

public DataTable GetChanges ()

JScript

public function GetChanges () : DataTable

戻り値
この DataTable からの変更のコピー。変更がない場合は null 参照 (Visual Basic では Nothing)。

解説

前回 DataTable を読み取るか、AcceptChanges を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。このコピーは、元の DataTable にマージできるように考慮して設計されています。リレーションシップ制約があるために、未変更の親行が含まれる場合があります。行が変更されていない場合、このメソッドは null 参照 (Visual Basic では Nothing) を返します。

使用例

Visual Basic

Private Sub UpdateDataTable(table As
 DataTable, _
    myDataAdapter As OleDbDataAdapter)

    Dim xDataTable As DataTable = table.GetChanges()

    ' Check the DataTable for errors.
    If xDataTable.HasErrors Then
        ' Insert code to resolve errors.
    End If

    ' After fixing errors, update the database with the DataAdapter
 
    myDataAdapter.Update(xDataTable)
End Sub

private void UpdateDataTable(DataTable table,
 
    OleDbDataAdapter myDataAdapter)
{
    DataTable xDataTable = table.GetChanges();

    // Check the DataTable for errors.
    if (xDataTable.HasErrors)
    {
        // Insert code to resolve errors.
    }

    // After fixing errors, update the database with the DataAdapter
 
    myDataAdapter.Update(xDataTable);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用
DataTable の作成と使用

DataTable.GetChanges メソッド (DataRowState)

前回 DataTable を読み取るか、AcceptChanges を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを、DataRowState によってフィルタ処理した後で取得します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function GetChanges ( _
    rowStates As DataRowState _
) As DataTable

Visual Basic (使用法)

Dim instance As DataTable
Dim rowStates As DataRowState
Dim returnValue As DataTable

returnValue = instance.GetChanges(rowStates)

public DataTable GetChanges (
    DataRowState rowStates
)

C++

public:
DataTable^ GetChanges (
    DataRowState rowStates
)

public DataTable GetChanges (
    DataRowState rowStates
)

JScript

public function GetChanges (
    rowStates : DataRowState
) : DataTable

パラメータ

rowStates: DataRowState 値の 1 つ。

戻り値
アクションを実行した後、Merge を使用して元のデータセットにマージするために使用できる、DataTable のフィルタ処理後のコピー。必要な DataRowState の行が見つからない場合、このメソッドは null 参照 (Visual Basic では Nothing) を返します。

解説

GetChanges メソッドを使用して、元のオブジェクトの変更だけを格納する 2 つ目の DataTable オブジェクトを作成します。引数 rowStates を使用して、新しいオブジェクトに格納する変更の種類を指定します。

リレーションシップ制約があるために、未変更の親行が含まれる場合があります。

使用例

Visual Basic

Private Sub ProcessDeletes(table As
 DataTable, _
    adapter As OleDbDataAdapter)

   Dim changeTable As DataTable = table.GetChanges(DataRowState.Deleted)

   ' Check the DataTable for errors.
   If table.HasErrors Then
      ' Insert code to resolve errors.
   End If

   ' After fixing errors, update the database with the DataAdapter 
   adapter.Update(changeTable)
End Sub

private void ProcessDeletes(DataTable table,
 
    OleDbDataAdapter adapter)
{
    DataTable changeTable = table.GetChanges(DataRowState.Deleted);

    // Check the DataTable for errors.
    if (changeTable.HasErrors)
    {
        // Insert code to resolve errors.
    }

    // After fixing errors, update the database with the DataAdapter
 
    adapter.Update(changeTable);
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用

DataTable.GetChanges メソッド

前回 DataTable を読み取るか、AcceptChanges を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。
オーバーロードの一覧

名前	説明
DataTable.GetChanges ()	前回 DataTable を読み取るか、AcceptChanges を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。 .NET Compact Framework によってサポートされています。
DataTable.GetChanges (DataRowState)	前回 DataTable を読み取るか、AcceptChanges を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを、DataRowState によってフィルタ処理した後で取得します。 .NET Compact Framework によってサポートされています。