DataContext.ObjectTrackingEnabled Property (System.Data.Linq)

ObjectTrackingEnabled Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

Microsoft Visual Studio 2010/.NET Framework 4.0

.NET Framework Class Library

DataContext..::.ObjectTrackingEnabled Property

Instructs the framework to track the original value and object identity for this DataContext.

Namespace: System.Data.Linq
Assembly: System.Data.Linq (in System.Data.Linq.dll)

Syntax

Visual Basic (Declaration)

Public Property ObjectTrackingEnabled As Boolean

Visual Basic (Usage)

Dim instance As DataContext
Dim value As Boolean

value = instance.ObjectTrackingEnabled

instance.ObjectTrackingEnabled = value

public bool ObjectTrackingEnabled { get; set; }

Visual C++

public:
property bool ObjectTrackingEnabled {
    bool get ();
    void set (bool value);
}

JScript

public function get ObjectTrackingEnabled () : boolean
public function set ObjectTrackingEnabled (value : boolean)

Property Value

Type: System..::.Boolean
true to enable object tracking; 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.

Topic	Location
How to: Retrieve Information As Read-Only	LINQ to SQL
How to: Retrieve Information As Read-Only	LINQ to SQL

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5

Reference

DataContext Class

DataContext Members

System.Data.Linq Namespace