DataSet.AcceptChanges メソッドとは何？わかりやすく解説 Weblio辞書

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

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

DataSet.AcceptChanges メソッド

この DataSet の読み込み、または前回の AcceptChanges の呼び出し以降にこのデータセットに対して行われたすべての変更をコミットします。

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

Visual Basic (宣言)

Public Sub AcceptChanges

Visual Basic (使用法)

Dim instance As DataSet

instance.AcceptChanges

public void AcceptChanges ()

C++

public:
void AcceptChanges ()

public void AcceptChanges ()

JScript

public function AcceptChanges ()

解説

DataRow クラスと DataTable クラスの両方に、AcceptChanges メソッドが含まれています。AcceptChanges を DataTable レベルで呼び出すと、各 DataRow の AcceptChanges メソッドが呼び出されます。同様に、DataSet で AcceptChanges を呼び出すと、DataSet 内の各テーブルで AcceptChanges が呼び出されます。このように、このメソッドを複数のレベルで呼び出すことができます。DataSet の AcceptChanges を呼び出すと、1 回の呼び出しで、すべての従属オブジェクト (テーブル、行など) でこのメソッドを呼び出すことができます。

DataSet で AcceptChanges を呼び出すと、編集モードの DataRow オブジェクトは、正常に編集を終了します。それぞれの DataRow の RowState プロパティも変更されます。Added 行および Modified 行は Unchanged になります。Deleted 行は削除されます。

DataSet に ForeignKeyConstraint オブジェクトが格納されている場合は、AcceptChanges メソッドを呼び出すと、AcceptRejectRule も適用されます。

使用例

DataRow を DataSet 内の DataTable に追加する例を次に示します。次に、DataSet で AcceptChanges メソッドを呼び出して、データセットに含まれるすべての DataTable オブジェクトに対して連鎖操作を実行します。

Visual Basic

Private Sub AcceptChanges()
   Dim myDataSet As DataSet
   myDataSet = new DataSet()

   ' Not shown: methods to fill the DataSet with data.
   Dim t As DataTable

   t = myDataSet.Tables("Suppliers")

   ' Add a DataRow to a table.
   Dim myRow As DataRow
   myRow = t.NewRow()
   myRow("CompanyID") = "NWTRADECO"
   myRow("CompanyName") = "NortWest
 Trade Company"

   ' Add the row.
   t.Rows.Add( myRow )

   ' Calling AcceptChanges on the DataSet causes AcceptChanges to be
   ' called on all subordinate objects.
   myDataSet.AcceptChanges()
End Sub

private void AcceptChanges()
{
   DataSet myDataSet;
   myDataSet = new DataSet();

   // Not shown: methods to fill the DataSet with data.
   DataTable t;
   t = myDataSet.Tables["Suppliers"];

   // Add a DataRow to a table.
   DataRow myRow;
   myRow = t.NewRow();
   myRow["CompanyID"] = "NWTRADECO";
   myRow["CompanyName"] = "NortWest Trade Company";

   // Add the row.
   t.Rows.Add( myRow );

   // Calling AcceptChanges on the DataSet causes AcceptChanges to be
   // called on all subordinate objects.
   myDataSet.AcceptChanges();
}