AuditTrailServiceBase.BeginSessionAudit(Session, AuditTrailStrategy) Method

Starts auditing object changes made within the specified session.

Namespace: DevExpress.Persistent.BaseImpl.AuditTrail.Services

Assembly: DevExpress.Persistent.BaseImpl.Xpo.v23.2.dll

NuGet Package: DevExpress.Persistent.BaseImpl.Xpo

Declaration

C#

public ObjectAuditProcessor BeginSessionAudit(
    Session session,
    AuditTrailStrategy strategy
)

VB.NET

Public Function BeginSessionAudit(
    session As Session,
    strategy As AuditTrailStrategy
) As ObjectAuditProcessor

Parameters

Name	Type	Description
session	Session	The Session to be audited.
strategy	DevExpress.Persistent.AuditTrail.AuditTrailStrategy	The AuditTrailStrategy value.

Returns

Type	Description
DevExpress.Persistent.AuditTrail.ObjectAuditProcessor	A processor that the Audit Trail Module uses for the specified auditingMode.

Remarks

Note

If you want to disable the Audit Trail Module, use solutions from the following help topic: Disable the Audit Trail Module.

The following code demonstrates how to call this method:

C# (.NET 6+)

using DevExpress.ExpressApp;
using DevExpress.Persistent.AuditTrail;
using DevExpress.Xpo;
using Microsoft.Extensions.DependencyInjection;
// ...
public partial class MyController : ViewController {
    protected override void OnActivated() {
        base.OnActivated();
        var auditTrailService = Application.ServiceProvider.GetRequiredService<AuditTrailService>();
        Session session = ((XPObjectSpace)ObjectSpace).Session;
        auditTrailService.EndSessionAudit(session);
        // ...
        auditTrailService.BeginSessionAudit(session, 
            AuditTrailStrategy.OnObjectChanged);
    }
    // ...
}

C# (.NET Framework)

using DevExpress.ExpressApp;
using DevExpress.Persistent.AuditTrail;
using DevExpress.Xpo;
// ...
public partial class MyController : ViewController {
    protected override void OnActivated() {
        base.OnActivated();
        Session session = ((XPObjectSpace)ObjectSpace).Session;
        AuditTrailService.Instance.EndSessionAudit(session);
        // ...
        AuditTrailService.Instance.BeginSessionAudit(session, 
            AuditTrailStrategy.OnObjectChanged);
    }
    // ...
}