Export (0) Print
Expand All

RelatedEnd.Load Method (MergeOption)

When overridden in a derived class, loads an object or objects from the related end with the specified merge option.

Namespace:  System.Data.Objects.DataClasses
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public abstract void Load(
	MergeOption mergeOption
)

Parameters

mergeOption
Type: System.Data.Objects.MergeOption

The MergeOption to use when merging objects into an existing EntityCollection<TEntity>.

Implements

IRelatedEnd.Load(MergeOption)

ExceptionCondition
InvalidOperationException

When the source object was retrieved by using a NoTracking query and the MergeOption is not NoTracking or the related objects are already loaded.

-or-

When the source object is not attached to the ObjectContext.

-or-

When the source object is being tracked but is in the Added or Deleted state or the MergeOption used for Load is NoTracking.

Both EntityCollection<TEntity> and EntityReference<TEntity> override this method to load related objects. Load is called to explicitly load related objects from a related end exposed by a navigation property. For more information, see Shaping Query Results (Entity Framework).

Calling the Load method sets the IsLoaded flag to true.

The Load method loads related objects from the data source whether or not IsLoaded is true.

The default merge option is AppendOnly for tracked objects or NoTracking when the object is not tracked in the ObjectStateManager.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft