DataSet.RejectChanges DataSet.RejectChanges DataSet.RejectChanges DataSet.RejectChanges Method

Definition

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 -> unit
Public 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.

Applies to