DoReplaceMerge Method

Overview

The DoReplaceMerge method performs a destructive reload: it clears all rows from the current data set tables and re-adds rows from the refreshed data set as Unchanged.

Declaration

/// <summary>
/// Dose Replace merge
/// </summary>
/// <param name="currentDataSet">Current data set</param>
/// <param name="refreshedDataSet">Refreshed data set</param>
/// <param name="mergeOptions">Merge options</param>
public static void DoReplaceMerge(this IDataSet? currentDataSet, IDataSet refreshedDataSet, IMergeOptions mergeOptions)

Namespace and Assembly

Namespace: PocoDataSet.Extensions
Assembly: PocoDataSet.Extensions.dll

Behavior

• If currentDataSet is null, the method returns without doing anything.
• For each table present in the refreshed data set, the corresponding table in current is cleared and refilled from refreshed.
• Rows from refreshed are added as loaded rows and end up in Unchanged state.
• Tables that exist only in the current data set are cleared (replaced by the refreshed snapshot).

Usage Example

// CURRENT has two tables with old data.
IDataSet current = DataSetFactory.CreateDataSet();

IDataTable t1 = current.AddNewTable("T1");
t1.AddColumn("Id", DataTypeNames.INT32, false, true);
t1.AddColumn("Name", DataTypeNames.STRING);
t1.AddNewRow()["Id"] = 1;
t1.Rows[0]["Name"] = "Old1";

IDataTable t2 = current.AddNewTable("T2");
t2.AddColumn("Id", DataTypeNames.INT32, false, true);
t2.AddColumn("Name", DataTypeNames.STRING);
t2.AddNewRow()["Id"] = 1;
t2.Rows[0]["Name"] = "Old2";

current.AcceptChanges();

// REFRESHED is a full snapshot from the server.
IDataSet refreshed = DataSetFactory.CreateDataSet();

IDataTable r1 = refreshed.AddNewTable("T1");
r1.AddColumn("Id", DataTypeNames.INT32, false, true);
r1.AddColumn("Name", DataTypeNames.STRING);
r1.AddNewRow()["Id"] = 10;
r1.Rows[0]["Name"] = "New1";

IDataTable r2 = refreshed.AddNewTable("T2");
r2.AddColumn("Id", DataTypeNames.INT32, false, true);
r2.AddColumn("Name", DataTypeNames.STRING);
r2.AddNewRow()["Id"] = 20;
r2.Rows[0]["Name"] = "New2";

refreshed.AcceptChanges();

IMergeOptions options = new MergeOptions();

// Act: replace everything.
current.DoReplaceMerge(refreshed, options);

// CURRENT now contains rows from REFRESHED.
Assert.Equal(10, t1.Rows[0].GetDataFieldValue<int>("Id"));
Assert.Equal("New1", t1.Rows[0].GetDataFieldValue<string>("Name"));

Notes

• Replace merge intentionally discards local changes. Use it only when you explicitly want a clean reload.

 

Table of Content POCO DataSet DataSet Members

 

---

Business Process Programming in .Net
© 2004–2026 Laskarzhevsky Software Inc.
Unless otherwise noted, the content of this website is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0).
Code examples are provided under the MIT License.
You are free to share and adapt the material provided that appropriate credit is given and any modifications are clearly indicated.
The information provided on this website is for educational purposes only.
The author and publisher make no warranties regarding the completeness or suitability of the information and are not responsible for any damages resulting from its use.