DataSet.Merge Metode

Referensi

Definisi

Ruang nama:: System.Data

Rakitan:: System.Data.Common.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menggabungkan DataSet, DataTable, atau array objek DataRow yang ditentukan ke dalam DataSet saat ini atau DataTable.

Overload

Merge(DataRow[])	Menggabungkan array objek DataRow ke dalam DataSetsaat ini.
Merge(DataSet)	Menggabungkan DataSet yang ditentukan dan skemanya ke dalam `DataSet`saat ini.
Merge(DataTable)	Menggabungkan DataTable yang ditentukan dan skemanya ke dalam DataSetsaat ini.
Merge(DataSet, Boolean)	Menggabungkan DataSet yang ditentukan dan skemanya ke dalam `DataSet`saat ini, mempertahankan atau membuang perubahan apa pun dalam `DataSet` ini sesuai dengan argumen yang diberikan.
Merge(DataRow[], Boolean, MissingSchemaAction)	Menggabungkan array objek DataRow ke dalam DataSetsaat ini, mempertahankan atau membuang perubahan dalam `DataSet` dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.
Merge(DataSet, Boolean, MissingSchemaAction)	Menggabungkan DataSet yang ditentukan dan skemanya dengan `DataSet`saat ini, mempertahankan atau membuang perubahan dalam `DataSet` saat ini dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.
Merge(DataTable, Boolean, MissingSchemaAction)	Menggabungkan DataTable yang ditentukan dan skemanya ke dalam `DataSet`saat ini, mempertahankan atau membuang perubahan dalam `DataSet` dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.

Merge(DataRow[])

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan array objek DataRow ke dalam DataSetsaat ini.

public:
 void Merge(cli::array <System::Data::DataRow ^> ^ rows);

public void Merge (System.Data.DataRow[] rows);

member this.Merge : System.Data.DataRow[] -> unit

Public Sub Merge (rows As DataRow())

Parameter

rows: DataRow[]

Array objek DataRow yang akan digabungkan ke dalam DataSet.

Keterangan

Metode Merge digunakan untuk menggabungkan dua objek DataSet yang memiliki skema yang sebagian besar serupa. Penggabungan biasanya digunakan pada aplikasi klien untuk menggabungkan perubahan terbaru dari sumber data ke dalam DataSetyang ada. Ini memungkinkan aplikasi klien untuk memiliki DataSet yang disegarkan dengan data terbaru dari sumber data.

Metode Merge biasanya dipanggil di akhir serangkaian prosedur yang melibatkan validasi perubahan, merekonsiliasi kesalahan, memperbarui sumber data dengan perubahan, dan akhirnya me-refresh DataSetyang ada.

Dalam aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Ketika metode Merge dipanggil, skema dua objek DataSet dibandingkan karena ada kemungkinan bahwa skema mungkin telah diubah. Misalnya, dalam skenario bisnis-ke-bisnis, kolom baru mungkin telah ditambahkan ke skema XML oleh proses otomatis. Jika sumber DataSet berisi elemen skema (ditambahkan objek DataColumn) yang hilang di target, elemen skema dapat ditambahkan ke target dengan mengatur argumen missingSchemaAction ke MissingSchemaAction.Add. Dalam hal ini, DataSet yang digabungkan berisi skema dan data yang ditambahkan.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Selama penggabungan, batasan dinonaktifkan. Jika ada batasan yang tidak dapat diaktifkan di akhir penggabungan, ConstraintException dihasilkan dan data gabungan dipertahankan saat batasan dinonaktifkan. Dalam hal ini, properti EnforceConstraints diatur ke false, dan semua baris yang tidak valid ditandai dalam kesalahan. Kesalahan harus diselesaikan sebelum mencoba mengatur ulang properti EnforceConstraints ke true.

Lihat juga

Menggunakan Himpunan Data di ADO.NET

Berlaku untuk

Merge(DataSet)

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan DataSet yang ditentukan dan skemanya ke dalam DataSetsaat ini.

public:
 void Merge(System::Data::DataSet ^ dataSet);

public void Merge (System.Data.DataSet dataSet);

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

Public Sub Merge (dataSet As DataSet)

Parameter

dataSet: DataSet

DataSet data dan skemanya akan digabungkan.

Pengecualian

ConstraintException

Satu atau beberapa batasan tidak dapat diaktifkan.

ArgumentNullException

dataSet null.

Contoh

Contoh berikut menggunakan metode GetChanges, Perbarui, dan Merge pada DataSet.

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 changeDataSet;

    // Add columns to table, and table to DataSet.
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    dataSet.Tables.Add(table);

    // 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 two 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.
        changeDataSet = dataSet.GetChanges(
            DataRowState.Modified|DataRowState.Added);
        PrintValues(changeDataSet, "Subset values");
        // Insert code to reconcile errors. In this case reject changes.
        foreach(DataTable changeTable in changeDataSet.Tables)
        {
            if (changeTable.HasErrors)
            {
                foreach(DataRow changeRow in changeTable.Rows)
                {
                    //Console.WriteLine(changeRow["Item"]);
                    if((int)changeRow["Item",
                        DataRowVersion.Current ]> 100)
                    {
                        changeRow.RejectChanges();
                        changeRow.ClearErrors();
                    }
                }
            }
        }
        PrintValues(changeDataSet, "Reconciled subset values");
        // Merge changes back to first DataSet.
        dataSet.Merge(changeDataSet);
        PrintValues(dataSet, "Merged Values");
    }
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    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"))

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

     ' Create variable for temporary DataSet. 
     Dim changeDataSet As DataSet

     ' Add columns to table, and table to DataSet.   
     table.Columns.Add(idColumn)
     table.Columns.Add(itemColumn)
     dataSet.Tables.Add(table)

     ' 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 two 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.
         changeDataSet = dataSet.GetChanges(DataRowState.Modified _
            Or DataRowState.Added)
         PrintValues(changeDataSet, "Subset values")

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

         ' Merge changes back to first DataSet.
         dataSet.Merge(changeDataSet)
         PrintValues(dataSet, "Merged Values")
     End If
 End Sub
 
Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(ControlChars.Cr & label)
     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

Keterangan

Dalam aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil, dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Lihat juga

Berlaku untuk

Merge(DataTable)

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan DataTable yang ditentukan dan skemanya ke dalam DataSetsaat ini.

public:
 void Merge(System::Data::DataTable ^ table);

public void Merge (System.Data.DataTable table);

member this.Merge : System.Data.DataTable -> unit

Public Sub Merge (table As DataTable)

Parameter

table: DataTable

DataTable data dan skemanya akan digabungkan.

Pengecualian

ArgumentNullException

table null.

Contoh

Contoh berikut membuat DataSet sederhana dengan satu tabel, dua kolom, dan sepuluh baris. DataTable kedua dibuat yang identik dengan yang pertama. Dua baris ditambahkan ke tabel kedua, yang kemudian digabungkan ke dalam DataSet.

private void DemonstrateMergeTable()
{
    // Create a DataSet with one table, two columns, and ten rows.
    DataSet dataSet = new DataSet("dataSet");
    DataTable table = new DataTable("Items");

    // Add table to the DataSet
    dataSet.Tables.Add(table);

    // Add columns
    DataColumn c1 = new DataColumn("id",
        Type.GetType("System.Int32"),"");
    DataColumn c2 = new DataColumn("Item",
        Type.GetType("System.Int32"),"");
    table.Columns.Add(c1);
    table.Columns.Add(c2);

    // DataColumn array to set primary key.
    DataColumn[] keyCol= new DataColumn[1];

    // Set primary key column.
    keyCol[0]= c1;
    table.PrimaryKey=keyCol;

    // Add a RowChanged event handler for the table.
    table.RowChanged += new
        DataRowChangeEventHandler(Row_Changed);

    // Add ten rows.
    for(int i = 0; i <10;i++)
    {
        DataRow row=table.NewRow();
        row["id"] = i;
        row["Item"]= i;
        table.Rows.Add(row);
    }
    // Accept changes.
    dataSet.AcceptChanges();

    PrintValues(dataSet, "Original values");

    // Create a second DataTable identical to the first.
    DataTable t2 = table.Clone();

    // Add three rows. Note that the id column can'te be the
    // same as existing rows in the DataSet table.
    DataRow newRow;
    newRow = t2.NewRow();
    newRow["id"] = 14;
    newRow["item"] = 774;

    //Note the alternative method for adding rows.
    t2.Rows.Add(new Object[] { 12, 555 });
    t2.Rows.Add(new Object[] { 13, 665 });

    // Merge the table into the DataSet
    Console.WriteLine("Merging");
    dataSet.Merge(t2);
    PrintValues(dataSet, "Merged With table.");
}

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("\n" + label);
    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 DemonstrateMergeTable()
    ' Create a DataSet with one table, two columns, 
    ' and ten rows.
    Dim dataSet As New DataSet("dataSet")
    Dim table As New DataTable("Items")

    ' Add tables to the DataSet
    dataSet.Tables.Add(table)

    ' Add columns
    Dim c1 As New DataColumn("id", Type.GetType("System.Int32"), "")
    Dim c2 As New DataColumn("Item", Type.GetType("System.Int32"), "")
    table.Columns.Add(c1)
    table.Columns.Add(c2)

    ' DataColumn array to set primary key.
    Dim keyCol(0) As DataColumn

    ' Set primary key column.
    keyCol(0) = c1
    table.PrimaryKey = keyCol

    ' Add RowChanged event handler for the table.
    AddHandler table.RowChanged, AddressOf Row_Changed

    ' Add ten rows.
    Dim i As Integer
    Dim row As DataRow

    For i = 0 To 9
        row = table.NewRow()
        row("id") = i
        row("Item") = i
        table.Rows.Add(row)
    Next i

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

    ' Create a second DataTable identical to the first.
    Dim t2 As DataTable
    t2 = table.Clone()

    ' Add three rows. Note that the id column can't be the 
    ' same as existing rows in the DataSet table.
    Dim newRow As DataRow
    newRow = t2.NewRow()
    newRow("id") = 14
    newRow("Item") = 774
    t2.Rows.Add(newRow)

    newRow = t2.NewRow()
    newRow("id") = 12
    newRow("Item") = 555
    t2.Rows.Add(newRow)

    newRow = t2.NewRow()
    newRow("id") = 13
    newRow("Item") = 665
    t2.Rows.Add(newRow)

    ' Merge the table into the DataSet.
    Console.WriteLine("Merging")
    dataSet.Merge(t2)
    PrintValues(dataSet, "Merged With Table")
 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(ControlChars.Cr & label)
     Dim table As DataTable
     Dim row As DataRow
     Dim column As DataColumn
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " & table.TableName) 
         For Each row In  table.Rows             
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & " " _
                    & row(column).ToString())
             Next column
             Console.WriteLine()
         Next row
     Next table
 End Sub

Keterangan

Dalam aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil, dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Lihat juga

Menggunakan Himpunan Data di ADO.NET

Berlaku untuk

Merge(DataSet, Boolean)

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan DataSet yang ditentukan dan skemanya ke dalam DataSetsaat ini, mempertahankan atau membuang perubahan apa pun dalam DataSet ini sesuai dengan argumen yang diberikan.

public:
 void Merge(System::Data::DataSet ^ dataSet, bool preserveChanges);

public void Merge (System.Data.DataSet dataSet, bool preserveChanges);

member this.Merge : System.Data.DataSet * bool -> unit

Public Sub Merge (dataSet As DataSet, preserveChanges As Boolean)

Parameter

dataSet: DataSet

DataSet data dan skemanya akan digabungkan.

preserveChanges: Boolean

true untuk mempertahankan perubahan dalam DataSetsaat ini; jika tidak, false.

Contoh

Contoh berikut membuat DataSet sederhana dengan satu tabel, dua kolom, dan sepuluh baris. Setelah menambahkan sepuluh baris, dua nilai diubah, dan satu baris ditambahkan. Subset data yang diubah dibuat menggunakan metode GetChanges. Setelah mendamaikan kesalahan, data subset digabungkan ke dalam DataSetasli.

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

Keterangan

Dalam aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil, dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Lihat juga

Berlaku untuk

Merge(DataRow[], Boolean, MissingSchemaAction)

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan array objek DataRow ke dalam DataSetsaat ini, mempertahankan atau membuang perubahan dalam DataSet dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.

public:
 void Merge(cli::array <System::Data::DataRow ^> ^ rows, bool preserveChanges, System::Data::MissingSchemaAction missingSchemaAction);

public void Merge (System.Data.DataRow[] rows, bool preserveChanges, System.Data.MissingSchemaAction missingSchemaAction);

member this.Merge : System.Data.DataRow[] * bool * System.Data.MissingSchemaAction -> unit

Public Sub Merge (rows As DataRow(), preserveChanges As Boolean, missingSchemaAction As MissingSchemaAction)

Parameter

rows: DataRow[]

Array objek DataRow yang akan digabungkan ke dalam DataSet.

preserveChanges: Boolean

true untuk mempertahankan perubahan dalam DataSet; jika tidak, false.

missingSchemaAction: MissingSchemaAction

Salah satu nilai MissingSchemaAction.

Keterangan

Dalam aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil, dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Untuk memfasilitasi penjelasan tentang metode Merge, kami menggunakan "target" untuk menandakan DataSetsaat ini , dan "sumber" untuk memberi nama (parameter) kedua DataSet. target DataSet begitu dinamai karena merupakan objek tempat tindakan (penggabungan) terjadi. DataSet kedua disebut "sumber" karena informasi yang dikandungnya tidak berubah, tetapi sebaliknya digabungkan ke dalam DataSetsaat ini.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Lihat juga

Menggunakan Himpunan Data di ADO.NET

Berlaku untuk

Merge(DataSet, Boolean, MissingSchemaAction)

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan DataSet yang ditentukan dan skemanya dengan DataSetsaat ini, mempertahankan atau membuang perubahan dalam DataSet saat ini dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.

public:
 void Merge(System::Data::DataSet ^ dataSet, bool preserveChanges, System::Data::MissingSchemaAction missingSchemaAction);

public void Merge (System.Data.DataSet dataSet, bool preserveChanges, System.Data.MissingSchemaAction missingSchemaAction);

member this.Merge : System.Data.DataSet * bool * System.Data.MissingSchemaAction -> unit

Public Sub Merge (dataSet As DataSet, preserveChanges As Boolean, missingSchemaAction As MissingSchemaAction)

Parameter

dataSet: DataSet

DataSet data dan skemanya akan digabungkan.

preserveChanges: Boolean

true untuk mempertahankan perubahan dalam DataSetsaat ini; jika tidak, false.

missingSchemaAction: MissingSchemaAction

Salah satu nilai MissingSchemaAction.

Pengecualian

ArgumentNullException

dataSet null.

Contoh

Contoh berikut membuat DataSet sederhana dengan satu tabel, dua kolom, dan sepuluh baris. Dua nilai diubah, dan satu baris ditambahkan. Subset data yang diubah dibuat menggunakan metode GetChanges. Setelah merekonsiliasi kesalahan, kolom baru ditambahkan ke subset, mengubah skema. Ketika metode Merge dipanggil dengan missingSchemaAction diatur ke MissingSchemaAction.Add, kolom baru ditambahkan ke skema objek DataSet asli.

private void DemonstrateMergeMissingSchema()
{
    // 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 changeDataSet;

    // 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.
        changeDataSet = dataSet.GetChanges(
            DataRowState.Modified|DataRowState.Added);
        PrintValues(changeDataSet, "Subset values");

        // Insert code to reconcile errors. Reject the changes.
        foreach(DataTable changeTable in changeDataSet.Tables)
        {
            if (changeTable.HasErrors)
            {
                foreach(DataRow changeRow in changeTable.Rows)
                {
                    //Console.WriteLine(changeRow["Item"]);
                    if((int)changeRow["Item",
                        DataRowVersion.Current ]> 100)
                    {
                        changeRow.RejectChanges();
                        changeRow.ClearErrors();
                    }
                }
            }
        }
        // Add a column to the changeDataSet to change the schema.
        changeDataSet.Tables["Items"].Columns.Add(
            new DataColumn("newColumn"));
        PrintValues(changeDataSet, "Reconciled subset values");

        // Add values to the rows for each column.
        foreach(DataRow rowItem in changeDataSet.Tables["Items"].Rows)
        {
            rowItem["newColumn"] = "my new schema value";
        }
        // Merge changes back to first DataSet.
        dataSet.Merge(changeDataSet, 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("\n" + label);
    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 DemonstrateMergeMissingSchema()
    ' 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"))

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

    ' Create variable for temporary DataSet. 
    Dim changeDataSet 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.
        changeDataSet = dataSet.GetChanges(DataRowState.Modified _
            Or DataRowState.Added)
        PrintValues(changeDataSet, "Subset values")
        ' Insert code to reconcile errors. In this case, reject changes.
        Dim changeTable As DataTable
        For Each changeTable In  changeDataSet.Tables
            If changeTable.HasErrors Then
                Dim changeRow As DataRow
                For Each changeRow In  changeTable.Rows
                    If CInt(changeRow("Item", _
                        DataRowVersion.Current)) > 100 Then
                        changeRow.RejectChanges()
                        changeRow.ClearErrors()
                    End If
                Next changeRow
            End If
        Next changeTable

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

        ' Add values to the rows for each column.
        Dim rowItem As DataRow
        For Each rowItem In  changeDataSet.Tables("Items").Rows
            rowItem("newColumn") = "my new schema value"
        Next rowItem

        ' Merge changes back to first DataSet.
        dataSet.Merge(changeDataSet, 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(ControlChars.Cr & label)
    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

Keterangan

Dalam aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil, dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Lihat juga

Menggunakan Himpunan Data di ADO.NET

Berlaku untuk

Merge(DataTable, Boolean, MissingSchemaAction)

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Sumber:: DataSet.cs

Menggabungkan DataTable yang ditentukan dan skemanya ke dalam DataSetsaat ini, mempertahankan atau membuang perubahan dalam DataSet dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.

public:
 void Merge(System::Data::DataTable ^ table, bool preserveChanges, System::Data::MissingSchemaAction missingSchemaAction);

public void Merge (System.Data.DataTable table, bool preserveChanges, System.Data.MissingSchemaAction missingSchemaAction);

member this.Merge : System.Data.DataTable * bool * System.Data.MissingSchemaAction -> unit

Public Sub Merge (table As DataTable, preserveChanges As Boolean, missingSchemaAction As MissingSchemaAction)

Parameter

table: DataTable

DataTable data dan skemanya akan digabungkan.

preserveChanges: Boolean

Salah satu nilai MissingSchemaAction.

missingSchemaAction: MissingSchemaAction

true untuk mempertahankan perubahan dalam DataSet; jika tidak, false.

Pengecualian

ArgumentNullException

dataSet null.

Contoh

Contoh berikut membuat DataSet sederhana dengan satu tabel, dua kolom, dan sepuluh baris. DataTable kedua dibuat yang hampir identik dengan yang pertama kecuali bahwa DataColumn baru ditambahkan ke tabel. Dua baris ditambahkan ke tabel kedua, yang kemudian digabungkan ke dalam DataSet dengan argumen preserveChanges diatur ke false, dan argumen missingSchemaAction diatur ke MissingSchemaAction.Add.

private void DemonstrateMergeTableAddSchema()
{
    // Create a DataSet with one table, two columns, and ten rows.
    DataSet dataSet = new DataSet("dataSet");
    DataTable table = new DataTable("Items");

    // Add table to the DataSet
    dataSet.Tables.Add(table);

    // Create and add two columns to the DataTable
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"),"");
    idColumn.AutoIncrement=true;
    DataColumn itemColumn = new DataColumn("Item",
        Type.GetType("System.Int32"),"");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);

    // Set the primary key to the first column.
    table.PrimaryKey = new DataColumn[1]{ idColumn };

    // Add RowChanged event handler for the table.
    table.RowChanged+= new DataRowChangeEventHandler(Row_Changed);

    // Add ten rows.
    for(int i = 0; i <10;i++)
    {
        DataRow row=table.NewRow();
        row["Item"]= i;
        table.Rows.Add(row);
    }

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

    // Create a second DataTable identical to the first, with
    // one extra column using the Clone method.
    DataTable cloneTable = table.Clone();
    cloneTable.Columns.Add("extra", typeof(string));

    // Add two rows. Note that the id column can'table be the
    // same as existing rows in the DataSet table.
    DataRow newRow;
    newRow=cloneTable.NewRow();
    newRow["id"]= 12;
    newRow["Item"]=555;
    newRow["extra"]= "extra Column 1";
    cloneTable.Rows.Add(newRow);

    newRow=cloneTable.NewRow();
    newRow["id"]= 13;
    newRow["Item"]=665;
    newRow["extra"]= "extra Column 2";
    cloneTable.Rows.Add(newRow);

    // Merge the table into the DataSet.
    Console.WriteLine("Merging");
    dataSet.Merge(cloneTable,false,MissingSchemaAction.Add);
    PrintValues(dataSet, "Merged With Table, Schema Added");
}

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("\n" + label);
    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 DemonstrateMergeTableAddSchema()
    ' Create a DataSet with one table, two columns, 
    'and ten rows.
    Dim dataSet As New DataSet("dataSet")
    Dim table As New DataTable("Items")

    ' Add tables to the DataSet
    dataSet.Tables.Add(table)

    ' Create and add two columns to the DataTable
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"), "")
    idColumn.AutoIncrement = True
    Dim itemColumn As New DataColumn("Item", _
        Type.GetType("System.Int32"), "")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)

    ' DataColumn array to set primary key.
    Dim keyCol(0) As DataColumn

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

    ' Add RowChanged event handler for the table.
    AddHandler table.RowChanged, AddressOf Row_Changed

    ' Add ten rows.
    Dim i As Integer
    Dim row As DataRow

    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")

    ' Create a second DataTable identical to the first
    ' with one extra column using the Clone method.
    Dim cloneTable As New DataTable
    cloneTable = table.Clone()

    ' Add column.
    cloneTable.Columns.Add("extra", _
        Type.GetType("System.String"))

    ' Add two rows. Note that the id column can't be the 
    ' same as existing rows in the DataSet table.
    Dim newRow As DataRow
    newRow = cloneTable.NewRow()
    newRow("id") = 12
    newRow("Item") = 555
    newRow("extra") = "extra Column 1"
    cloneTable.Rows.Add(newRow)
        
    newRow = cloneTable.NewRow()
    newRow("id") = 13
    newRow("Item") = 665
    newRow("extra") = "extra Column 2"
    cloneTable.Rows.Add(newRow)

    ' Merge the table into the DataSet.
    Console.WriteLine("Merging")
    dataSet.Merge(cloneTable, False, MissingSchemaAction.Add)
    PrintValues(dataSet, "Merged With Table, Schema Added")
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(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " _
                    & row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
 End Sub

Keterangan

iOn aplikasi klien, adalah umum untuk memiliki satu tombol yang dapat diklik pengguna yang mengumpulkan data yang diubah dan memvalidasinya sebelum mengirimkannya kembali ke komponen tingkat menengah. Dalam skenario ini, metode GetChanges pertama kali dipanggil. Metode tersebut mengembalikan DataSet kedua yang dioptimalkan untuk memvalidasi dan menggabungkan. Objek DataSet kedua ini hanya berisi objek DataTable dan DataRow yang diubah, menghasilkan subset DataSetasli . Subset ini umumnya lebih kecil, dan dengan demikian lebih efisien diteruskan kembali ke komponen tingkat menengah. Komponen tingkat menengah kemudian memperbarui sumber data asli dengan perubahan melalui prosedur tersimpan. Tingkat tengah kemudian dapat mengirim kembali DataSet baru yang menyertakan data asli dan data terbaru dari sumber data (dengan menjalankan kueri asli lagi), atau dapat mengirim kembali subset dengan perubahan apa pun yang telah dilakukan dari sumber data. (Misalnya, jika sumber data secara otomatis membuat nilai kunci utama yang unik, nilai-nilai ini dapat disebarluaskan kembali ke aplikasi klien.) Dalam kedua kasus, DataSet yang dikembalikan dapat digabungkan kembali ke DataSet asli aplikasi klien dengan metode Merge.

Setelah menggabungkan skema, data digabungkan.

Saat menggabungkan sumber baru DataSet ke target, baris sumber apa pun dengan nilai DataRowStateUnchanged, Modified, atau Deleted dicocokkan dengan baris target dengan nilai kunci utama yang sama. Baris sumber dengan nilai DataRowStateAdded dicocokkan dengan baris target baru dengan nilai kunci utama yang sama dengan baris sumber baru.

Lihat juga

Menggunakan Himpunan Data di ADO.NET

Berlaku untuk

Bagikan melalui

DataSet.Merge Metode

Definisi

Overload

Merge(DataRow[])

Parameter

Keterangan

Lihat juga

Berlaku untuk

Merge(DataSet)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Merge(DataTable)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Merge(DataSet, Boolean)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Merge(DataRow[], Boolean, MissingSchemaAction)

Parameter

Keterangan

Lihat juga

Berlaku untuk

Merge(DataSet, Boolean, MissingSchemaAction)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Merge(DataTable, Boolean, MissingSchemaAction)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: