DataContext.ObjectTrackingEnabled Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.