DataSet.RejectChanges Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Rolls back all the changes made to the DataSet since it was created, or since the last time AcceptChanges() was called.
public:
virtual void RejectChanges();public virtual void RejectChanges ();abstract member RejectChanges : unit -> unit
override this.RejectChanges : unit -> unitPublic Overridable Sub RejectChanges ()Examples
The following example shows a class derived from the DataSet class. The RejectChanges event is invoked from within a function.
private void RejectChangesInDataSet()
{
// Instantiate the derived DataSet.
DerivedDataSet derivedData = new DerivedDataSet();
// Insert code to change values.
// Invoke the RejectChanges method in the derived class.
derivedData.RejectDataSetChanges();
}
public class DerivedDataSet:System.Data.DataSet
{
public void RejectDataSetChanges()
{
// Invoke the RejectChanges method.
this.RejectChanges();
}
}
Private Sub RejectChangesInDataSet()
' Instantiate the derived DataSet.
Dim derivedData As DerivedDataSet
derivedData = New DerivedDataSet()
' Insert code to change values.
' Invoke the RejectChanges method in the derived class.
derivedData.RejectDataSetChanges()
End Sub
Public Class DerivedDataSet
Inherits System.Data.DataSet
Public Sub RejectDataSetChanges()
' Invoke the RejectChanges method.
Me.RejectChanges()
End Sub
End Class
Remarks
Invoke the DataSet.RejectChanges to call the DataTable.RejectChanges method on all DataTable objects contained by the DataSet.
DataRow objects contained by the DataSet can each be set into edit mode by invoking the DataRow.BeginEdit method. After invoking the DataRow.EndEdit method, changes can be rejected by calling the DataTable.RejectChanges on the DataTable to which the DataRow objects belong.
When the DataTable.RejectChanges method is called, any rows still in edit-mode cancel their edits. New rows are removed. Modified and deleted rows return back to their original state (DataRowState.Unchanged).
AcceptChanges and RejectChanges only apply to DataRow related changes (that is, Add, Remove, Delete, and Modify). They are not applicable to schema or structural changes.
