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

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

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

DataRow.AcceptChanges メソッド

前回 AcceptChanges を呼び出した以降にこの行に対して行われたすべての変更をコミットします。

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

Visual Basic (宣言)

Public Sub AcceptChanges

Visual Basic (使用法)

Dim instance As DataRow

instance.AcceptChanges

public void AcceptChanges ()

C++

public:
void AcceptChanges ()

public void AcceptChanges ()

JScript

public function AcceptChanges ()

例外

例外の種類	条件
RowNotInTableException	行がこのテーブルに属していません。

解説

AcceptChanges を呼び出すと、EndEdit メソッドが暗黙的に呼び出されて、編集が終了します。この行の RowState が Added または Modified だった場合、RowState は Unchanged になります。RowState が Deleted だった場合、その行は削除されます。

詳細については、BeginEdit メソッドのトピックを参照してください。

DataTable クラスには、テーブル全体に影響を与える AcceptChanges メソッドも含まれます。

使用例

初めに 1 列の新しい DataTable を作成してから、単一の DataRow を作成する例を次に示します。DataRow の作成、追加、変更、および削除時に、その RowState が出力されます。

Visual Basic

Private Sub DemonstrateAcceptChanges()
    ' Run a function to create a DataTable with one column.
    Dim table As DataTable = MakeTable()
    Dim row As DataRow 
 
    ' Create a new DataRow.
    row = table.NewRow()
    ' Detached row.
    Console.WriteLine("New Row " & row.RowState)
 
    table.Rows.Add(row)
    ' New row.
    Console.WriteLine("AddRow " & row.RowState)
 
    table.AcceptChanges()
    ' Unchanged row.
    Console.WriteLine("AcceptChanges " & row.RowState)
 
    row("FirstName") = "Scott"
    ' Modified row.
    Console.WriteLine("Modified " & row.RowState)
 
    row.Delete()
    ' Deleted row.
    Console.WriteLine("Deleted " & row.RowState)
 End Sub
 
 Private Function MakeTable()As DataTable
    ' Make a simple table with one column.
    Dim table As DataTable = New
 DataTable("table")
    Dim fnameColumn As DataColumn = New
 DataColumn( _
        "FirstName", Type.GetType("System.String"))
    table.Columns.Add(fnameColumn)
    MakeTable = table
 End Function

private void DemonstrateAcceptChanges()
{
    //Run a function to create a DataTable with one column.
    DataTable table = MakeTable();
    DataRow row;
 
    // Create a new DataRow.
    row = table.NewRow();
    // Detached row.
    Console.WriteLine("New Row " + row.RowState);
 
    table.Rows.Add(row);
    // New row.
    Console.WriteLine("AddRow " + row.RowState);
 
    table.AcceptChanges();
    // Unchanged row.
    Console.WriteLine("AcceptChanges " + row.RowState);
 
    row["FirstName"] = "Scott";
    // Modified row.
    Console.WriteLine("Modified " + row.RowState);
 
    row.Delete();
    // Deleted row.
    Console.WriteLine("Deleted " + row.RowState);
}
 
private DataTable MakeTable()
{
    // Make a simple table with one column.
    DataTable table = new DataTable("table");
    DataColumn fnameColumn = new DataColumn(
        "FirstName", Type.GetType("System.String"));
    table.Columns.Add(fnameColumn);
    return table;
}