LinqConnect Documentation
Devart.Data.Linq Namespace / DataContext Class / DeferredLoadingEnabled Property

In This Topic
    DeferredLoadingEnabled Property
    In This Topic
    Instructs the framework not to delay-load one-to-many or one-to-one relationships.
    Syntax
    'Declaration
     
    Public Property DeferredLoadingEnabled As Boolean
    public bool DeferredLoadingEnabled {get; set;}

    Property Value

    true if the delay-loading one-to-many or one-to-one relationships is enabled; otherwise, false.
    Remarks
    When the code accesses one of these relationships, null is returned if the relationship is one-to-one, and an empty collection is returned if it is one-to-many. The relationships can still be filled by setting the LoadOptions property. The main scenario for this property is to enable you to extract a piece of the object model and send it out (for example, to a Web service).

    Note

    If this property is set to false after a query has been executed, an exception is thrown. See the Valid Modes section.

    Valid modes

    Deferred loading requires object tracking. Only the following three modes are valid:

    • ObjectTracking = false. DeferredLoading is ignored and inferred to be false. This behavior corresponds to a read-only DataContext.
    • ObjectTracking = true. DeferredLoading = false. This situation corresponds to a DataContext that allows users to load an object graph by using LoadWith directives, but it does not enable deferred loading.
    • Both are set to true. This is the default.

    The flags may not be changed after a query has been executed. Any change after the execution of the first query that uses that DataContext throws an exception.

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also