Session.BeginTrackingChanges() Method

Enables tracking changes made to persistent objects.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v24.1.dll

NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.TreeMap, DevExpress.Xpo

NuGet Package: DevExpress.Xpo

Declaration

C#

public void BeginTrackingChanges()

VB.NET

Public Sub BeginTrackingChanges

Remarks

Units of work (ExplicitUnitOfWork and UnitOfWork) automatically track changes made to persistent objects within their scope. In sessions, you need to call the BeginTrackingChanges method to enable tracking changes. To determine if changes are currently being tracked in a session, use the Session.TrackingChanges property.

Calling the BeginTrackingChanges method automatically starts a transaction (a database level transaction in an explicit unit of work) and raises the Session.BeforeBeginTrackingChanges and Session.AfterBeginTrackingChanges events, allowing you to monitor progress.

To manage changes made in a session or unit of work, use the Session.FlushChanges, Session.FlushChangesAsync, and Session.DropChanges methods.

Note

If the Session.TrackingChanges property returns true, calling the BeginTrackingChanges method throws an exception.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the BeginTrackingChanges() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-grid-implement-crud-operations-xpinstantfeedbacksource/CS/DXServermode2/Form1.cs#L75

{
    session1.BeginTrackingChanges();
    oldRowsCount = gridView1.DataRowCount;

VB.NET

winforms-grid-implement-crud-operations-xpinstantfeedbacksource/VB/DXServermode2/Form1.vb#L65

Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    session1.BeginTrackingChanges()
    oldRowsCount = gridView1.DataRowCount