.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+

XpoDefault.TrackPropertiesModifications Property

Specifies the default value of the Session.TrackPropertiesModifications property of all Sessions.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v19.2.dll

Declaration

public static bool TrackPropertiesModifications { get; set; }
Public Shared Property TrackPropertiesModifications As Boolean
public static bool TrackPropertiesModifications { get; set; }
Public Shared Property TrackPropertiesModifications As Boolean

Property Value

Type Description
Boolean

The boolean value specifying the default value of the Session.TrackPropertiesModifications property of all Sessions. The default is false.

Property Value

Type Description
Boolean

The boolean value specifying the default value of the Session.TrackPropertiesModifications property of all Sessions. The default is false.

Remarks

When the TrackPropertiesModifications is set to true, field-level optimistic locking is enabled. Its behavior can be configured via the OptimisticLockingAttribute attribute and the Session.OptimisticLockingReadBehavior property.

You can enable/disable property tracking for each persistent type individually by applying the OptimisticLockingReadBehaviorAttribute attribute. This attribute overrides the TrackPropertiesModifications setting of the Session. To disable optimistic locking for a specific persistent property, apply the OptimisticLockingIgnoredAttribute to this property.

Properties Implementation Requirements

To support this functionality, persistent properties should be implemented in a specific manner. If you implement your business model in code, use either the SetPropertyValue or OnChanged method in persistent property setters. These methods have several overloads. Use the overloads that take both the old and new property values:


SetPropertyValue(nameof(PropertyName), ref propertyValueHolder, value);

OnChanged(nameof(PropertyName), propertyValueHolder, value);

If you use the Data Model Designer to create the data model, then you do not need to worry about implementing persistent properties. Designer automatically declares persistent properties in the proper manner.

See Also