DataSet.GetChanges DataSet.GetChanges DataSet.GetChanges DataSet.GetChanges Method

定義

前回 DataSet を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。Gets a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges() was called.

オーバーロード

GetChanges() GetChanges() GetChanges() GetChanges()

前回 DataSet を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。Gets a copy of the DataSet that contains all changes made to it since it was loaded or since AcceptChanges() was last called.

GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState)

前回 DataSet を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを、DataRowState によってフィルター処理した後で取得します。Gets a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges() was called, filtered by DataRowState.

GetChanges() GetChanges() GetChanges() GetChanges()

前回 DataSet を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。Gets a copy of the DataSet that contains all changes made to it since it was loaded or since AcceptChanges() was last called.

public:
 System::Data::DataSet ^ GetChanges();
public System.Data.DataSet GetChanges ();
member this.GetChanges : unit -> System.Data.DataSet
Public Function GetChanges () As DataSet

戻り値

この DataSet の変更内容のコピー。これに対してアクションを実行した後、Merge(DataSet) を使って元のデータにマージできます。A copy of the changes from this DataSet that can have actions performed on it and later be merged back in using Merge(DataSet). 変更された行が見つからない場合、このメソッドは null を返します。If no changed rows are found, the method returns null.

次の例では、 DataSet 1 つのテーブル、2つの列、および10個の行を含む単純なを作成します。The following example creates a simple DataSet with one table, two columns, and ten rows. 2つの値が変更され、1つの行が追加されます。Two values are changed, and one row is added. 変更されたデータのサブセットは、 GetChangesメソッドを使用して作成されます。A subset of the changed data is created using the GetChanges method. エラーを調整した後、新しい列がサブセットに追加され、スキーマが変更されます。After reconciling errors, a new column is added to the subset, changing the schema. missingSchemaAction DataSetをにMerge 設定してメソッドを呼び出すと、新しい列が元のオブジェクトのスキーマに追加されます。MissingSchemaAction.AddWhen the Merge method is called with the missingSchemaAction set to MissingSchemaAction.Add, the new column is added to the original DataSet object's schema.

   private void DemonstrateMerge()
   {
       // Create a DataSet with one table, two columns, 
       // and three rows.
       DataSet dataSet = new DataSet("dataSet");
       DataTable table = new DataTable("Items");
       DataColumn idColumn = new DataColumn("id", 
           Type.GetType("System.Int32"),"");
       idColumn.AutoIncrement=true;
       DataColumn itemColumn = new DataColumn("Item", 
           Type.GetType("System.Int32"),"");

       // DataColumn array to set primary key.
       DataColumn[] keyColumn= new DataColumn[1];
       DataRow row;

       // Create variable for temporary DataSet. 
       DataSet changesDataSet;

       // Add RowChanged event handler for the table.
       table.RowChanged+=new DataRowChangeEventHandler(
           Row_Changed);
       dataSet.Tables.Add(table);
       table.Columns.Add(idColumn);
       table.Columns.Add(itemColumn);

       // Set primary key column.
       keyColumn[0]= idColumn;
       table.PrimaryKey=keyColumn;
       // Add ten rows.
       for(int i = 0; i <10;i++)
       {
           row=table.NewRow();
           row["Item"]= i;
           table.Rows.Add(row);
       }
       // Accept changes.
       dataSet.AcceptChanges();
       PrintValues(dataSet, "Original values");

       // Change row values.
       table.Rows[0]["Item"]= 50;
       table.Rows[1]["Item"]= 111;

       // Add one row.
       row=table.NewRow();
       row["Item"]=74;
       table.Rows.Add(row);

       // Insert code for error checking. Set one row in error.
       table.Rows[1].RowError= "over 100";
       PrintValues(dataSet, "Modified and New Values");

       // If the table has changes or errors, 
       // create a subset DataSet.
       if(dataSet.HasChanges(DataRowState.Modified | 
           DataRowState.Added)&& dataSet.HasErrors)
       {
           // Use GetChanges to extract subset.
           changesDataSet = dataSet.GetChanges(
               DataRowState.Modified|DataRowState.Added);
           PrintValues(changesDataSet, "Subset values");

           // Insert code to reconcile errors. In this case, reject changes.
           foreach(DataTable changesTable in changesDataSet.Tables)
           {
               if (changesTable.HasErrors)
               {
                   foreach(DataRow changesRow in changesTable.Rows)
                   {
                       //Console.WriteLine(changesRow["Item"]);
                       if((int)changesRow["Item",DataRowVersion.Current ]> 100)
                       {
                           changesRow.RejectChanges();
                           changesRow.ClearErrors();
                       }
                   }
               }
           }
           // Add a column to the changesDataSet.
           changesDataSet.Tables["Items"].Columns.Add(
               new DataColumn("newColumn"));
           PrintValues(changesDataSet, "Reconciled subset values");
           // Merge changes back to first DataSet.
           dataSet.Merge(changesDataSet, false, 
               System.Data.MissingSchemaAction.Add);
       }
       PrintValues(dataSet, "Merged Values");
   }

   private void Row_Changed(object sender, DataRowChangeEventArgs e)
   {
       Console.WriteLine("Row Changed " + e.Action.ToString() 
           + "\table" + e.Row.ItemArray[0]);
   }

   private void PrintValues(DataSet dataSet, string label)
   {
       Console.WriteLine(label + "\n");
       foreach(DataTable table in dataSet.Tables)
       {
           Console.WriteLine("TableName: " + table.TableName);
           foreach(DataRow row in table.Rows)
           {
               foreach(DataColumn column in table.Columns)
               {
                   Console.Write("\table " + row[column] );
               }
               Console.WriteLine();
           }
       }
   }
Private Sub DemonstrateMerge()
    ' Create a DataSet with one table, two columns, 
    ' and three rows.
    Dim dataSet As New DataSet("dataSet")
    Dim table As New DataTable("Items")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"), "")
    idColumn.AutoIncrement = True
    Dim itemColumn As New DataColumn("Item", _
        Type.GetType("System.Int32"), "")

    ' Create DataColumn array to set primary key.
    Dim keyColumn(0) As DataColumn
    Dim row As DataRow

    ' Create variable for temporary DataSet. 
    Dim changesDataSet As DataSet

    ' Add RowChanged event handler for the table.
    AddHandler table.RowChanged, AddressOf Row_Changed
    dataSet.Tables.Add(table)
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)

    ' Set primary key column.
    keyColumn(0) = idColumn
    table.PrimaryKey = keyColumn

    ' Add ten rows.
    Dim i As Integer
    For i = 0 To 9
        row = table.NewRow()
        row("Item") = i
        table.Rows.Add(row)
    Next i

    ' Accept changes.
    dataSet.AcceptChanges()
    PrintValues(dataSet, "Original values")

    ' Change row values.
    table.Rows(0)("Item") = 50
    table.Rows(1)("Item") = 111

    ' Add one row.
    row = table.NewRow()
    row("Item") = 74
    table.Rows.Add(row)

    ' Insert code for error checking. Set one row in error.
    table.Rows(1).RowError = "over 100"
    PrintValues(dataSet, "Modified and New Values")

    ' If the table has changes or errors, create a subset DataSet.
    If dataSet.HasChanges(DataRowState.Modified Or DataRowState.Added) _
        And dataSet.HasErrors Then
        ' Use GetChanges to extract subset.
        changesDataSet = dataSet.GetChanges( _
            DataRowState.Modified Or DataRowState.Added)
        PrintValues(changesDataSet, "Subset values")

        ' Insert code to reconcile errors. In this case, reject changes.
        Dim changesTable As DataTable
        For Each changesTable In  changesDataSet.Tables
            If changesTable.HasErrors Then
                Dim changesRow As DataRow
                For Each changesRow In  changesTable.Rows
                    'Console.WriteLine(changesRow["Item"]);
                    If CInt(changesRow("Item", _
                        DataRowVersion.Current)) > 100 Then
                        changesRow.RejectChanges()
                        changesRow.ClearErrors()
                    End If
                Next changesRow
            End If
        Next changesTable

        ' Add a column to the changesDataSet.
        changesDataSet.Tables("Items").Columns.Add( _
            New DataColumn("newColumn"))
        PrintValues(changesDataSet, "Reconciled subset values")

        ' Merge changes back to first DataSet.
        dataSet.Merge(changesDataSet, False, _
            System.Data.MissingSchemaAction.Add)
    End If
    PrintValues(dataSet, "Merged Values")
End Sub
        
 Private Sub Row_Changed(sender As Object, e As DataRowChangeEventArgs)
     Console.WriteLine("Row Changed " + e.Action.ToString() _
        + ControlChars.Tab + e.Row.ItemArray(0).ToString())
 End Sub
    
Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(label + ControlChars.Cr)
     Dim table As DataTable
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " + table.TableName)
         Dim row As DataRow
         For Each row In  table.Rows
             Dim column As DataColumn
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & " " _
                    & row(column).ToString())
             Next column
             Console.WriteLine()
         Next row
     Next table
End Sub

注釈

保留中のDataSet変更がある元DataSetの内のすべての行のコピーを含む新しいを作成します。Creates a new DataSet that contains a copy of all rows in the original DataSet that have pending changes. リレーションシップの制約により、変更された行の外部DataSetキーに対応する主キーが変更されていない行に含まれている場合は、変更されていない行が新しいに追加される可能性があります。Relationship constraints can cause additional unchanged rows to be added to the new DataSet if the unchanged rows contain primary keys corresponding to foreign keys in the changed rows. nullDataSetのに保留中の変更がある行がない場合、メソッドはを返します。The method returns null if there are no rows in the original DataSet that have pending changes.

こちらもご覧ください

GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState)

前回 DataSet を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを、DataRowState によってフィルター処理した後で取得します。Gets a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges() was called, filtered by DataRowState.

public:
 System::Data::DataSet ^ GetChanges(System::Data::DataRowState rowStates);
public System.Data.DataSet GetChanges (System.Data.DataRowState rowStates);
member this.GetChanges : System.Data.DataRowState -> System.Data.DataSet
Public Function GetChanges (rowStates As DataRowState) As DataSet

パラメーター

rowStates
DataRowState DataRowState DataRowState DataRowState

DataRowState 値のいずれか 1 つ。One of the DataRowState values.

戻り値

アクションを実行した後、DataSet を使用して元のデータセットにマージするために使用できる、Merge(DataSet) のフィルター処理後のコピー。A filtered copy of the DataSet that can have actions performed on it, and subsequently be merged back in using Merge(DataSet). 必要な DataRowState の行が見つからない場合、このメソッドは null を返します。If no rows of the desired DataRowState are found, the method returns null.

次の例ではGetChanges 、メソッドを使用しDataSetて2番目のオブジェクトを作成し、そのオブジェクトを使用してデータソースを更新します。The following example uses the GetChanges method to create a second DataSet object, which is then used to update a data source.

private void UpdateDataSet(DataSet dataSet)
{
    // Check for changes with the HasChanges method first.
    if(!dataSet.HasChanges(DataRowState.Modified)) return;

    // Create temporary DataSet variable and
    // GetChanges for modified rows only.
    DataSet tempDataSet = 
        dataSet.GetChanges(DataRowState.Modified);

    // Check the DataSet for errors.
    if(tempDataSet.HasErrors)
    {
        // Insert code to resolve errors.
    }
    // After fixing errors, update the data source with  
    // the DataAdapter used to create the DataSet.
    adapter.Update(tempDataSet);
}
Private Sub UpdateDataSet(ByVal dataSet As DataSet)
   ' Check for changes with the HasChanges method first.
   If Not dataSet.HasChanges(DataRowState.Modified) Then 
       Exit Sub
   End If

   ' Create temporary DataSet variable and
   ' GetChanges for modified rows only.
   Dim tempDataSet As DataSet = _
       dataSet.GetChanges(DataRowState.Modified)

   ' Check the DataSet for errors.
   If tempDataSet.HasErrors Then
      ' Insert code to resolve errors.
   End If

   ' After fixing errors, update the data source with   
   ' the DataAdapter used to create the DataSet.
   adapter.Update(tempDataSet)
End Sub

注釈

メソッドは、元のに導入さDataSetれた変更のみを含む2番目のオブジェクトを生成するために使用されます。 GetChangesThe GetChanges method is used to produce a second DataSet object that contains only the changes introduced into the original. rowStates引数を使用して、新しいオブジェクトに含める変更の種類を指定します。Use the rowStates argument to specify the type of changes the new object should include.

この返されたコピーは、この元DataSetのにマージされるように設計されています。This returned copy is designed to be merged back in to this original DataSet. リレーションシップの制約によって、 Unchanged親の行が含まれているとマークされることがあります。Relationship constraints may cause parent rows marked Unchanged to be included. 目的DataRowStateのの行が見つからない場合、メソッドGetChangesはをnull返します。If no rows of the desired DataRowState are found, the GetChanges method returns null.

こちらもご覧ください

適用対象