Edit

Share via


DataContext.ObjectTrackingEnabled Property

Definition

Gets or sets a value that indicates whether object tracking is enabled.

public:
 property bool ObjectTrackingEnabled { bool get(); void set(bool value); };
public bool ObjectTrackingEnabled { get; set; }
member this.ObjectTrackingEnabled : bool with get, set
Public Property ObjectTrackingEnabled As Boolean

Property Value

true if the object tracking is enabled; otherwise, false. The default is true.

Remarks

Setting this property to false improves performance at retrieval time, because there are fewer items to track.

An exception is thrown:

  • If the property is set to false after a query has been executed.

    For more information, see the Valid Modes section in DataContext.

  • If the property is set to false and SubmitChanges is called.

If ObjectTrackingEnabled is false, DeferredLoadingEnabled is ignored and treated as false. In this case, the DataContext is read-only.

If ObjectTrackingEnabled is true, DeferredLoadingEnabled is false. In this case, DataContext allows you to load an object graph by using LoadWith directives, but does not enable deferred loading.

Applies to