DataSet.GetChanges Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

En son yüklendiğinden DataSet veya çağrıldığından bu yana AcceptChanges() yapılan tüm değişiklikleri içeren bir kopyasını alır.

Aşırı Yüklemeler

Name	Description
GetChanges()	Yüklendikten veya en son çağrıldığından bu yana DataSet yapılan tüm değişiklikleri içeren bir kopyasını AcceptChanges() alır.
GetChanges(DataRowState)	en son yüklendiğinden DataSet veya çağrıldığından beri AcceptChanges() yapılan tüm değişiklikleri içeren bir kopyasını tarafından DataRowStatefiltrelenir.

GetChanges()

Kaynak:

DataSet.cs

Yüklendikten veya en son çağrıldığından bu yana DataSet yapılan tüm değişiklikleri içeren bir kopyasını AcceptChanges() alır.

public:
 System::Data::DataSet ^ GetChanges();

public System.Data.DataSet? GetChanges();

member this.GetChanges : unit -> System.Data.DataSet

Public Function GetChanges () As DataSet

Döndürülenler

DataSet

Üzerinde eylemlerin gerçekleştirilebileceği ve daha sonra kullanılarak DataSetyeniden birleştirilebilen bu Merge(DataSet) değişikliklerden bir kopyası. Değiştirilen satır bulunmazsa yöntemi döndürür null.

Örnekler

Aşağıdaki örnek, bir tablo, iki sütun ve on satır içeren basit bir DataSet oluşturur. İki değer değiştirilir ve bir satır eklenir. Değiştirilen verilerin bir alt kümesi GetChanges yöntemi kullanılarak oluşturulur. Hataların uzlaştırıldıktan sonra alt kümeye yeni bir sütun eklenerek şema değiştirilir. Merge yöntemi missingSchemaActionMissingSchemaAction.Addolarak ayarlandığında, yeni sütun özgün DataSet nesnesinin şemasına eklenir.

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

Açıklamalar

Bekleyen değişiklikleri olan özgün DataSet satırlardaki tüm satırların bir kopyasını içeren yeni DataSet bir oluşturur. İlişki kısıtlamaları, değişmeyen satırlar değiştirilen satırlardaki yabancı anahtarlara karşılık gelen birincil anahtarlar içeriyorsa, yeniye DataSet ek değişmeyen satırların eklenmesine neden olabilir. yöntemi, özgün null dosyada bekleyen değişiklikleri olan satır yoksa döndürürDataSet.

Ayrıca bkz.

• HasChanges()
• ADO.NET'da DataSet'leri kullanma

GetChanges(DataRowState)

Kaynak:

DataSet.cs

en son yüklendiğinden DataSet veya çağrıldığından beri AcceptChanges() yapılan tüm değişiklikleri içeren bir kopyasını tarafından DataRowStatefiltrelenir.

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

Parametreler

rowStates

DataRowState

Değerlerden DataRowState biri.

Döndürülenler

DataSet

üzerinde eylemlerin DataSet gerçekleştirilebileceği ve daha sonra kullanılarak Merge(DataSet)yeniden birleştirilebilen filtrelenmiş bir kopyası. İstenen DataRowState satır bulunamazsa yöntemi döndürür null.

Örnekler

Aşağıdaki örnek, ikinci GetChanges bir nesne oluşturmak için yöntemini kullanır DataSet ve bu nesne daha sonra bir veri kaynağını güncelleştirmek için kullanılır.

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

Açıklamalar

GetChanges yöntemi, yalnızca özgün nesneye tanıtılan değişiklikleri içeren ikinci DataSet bir nesne oluşturmak için kullanılır. Yeni nesnenin rowStates içermesi gereken değişikliklerin türünü belirtmek için bağımsız değişkenini kullanın.

Döndürülen bu kopya, içinde bu özgün DataSetile birleştirilecek şekilde tasarlanmıştır. İlişki kısıtlamaları, işaretlenmiş Unchanged üst satırların dahil edilmesine neden olabilir. İstenen DataRowState satır bulunamazsa GetChanges yöntemi döndürür null.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma