ObjectContext.LoadProperty Метод

Определение

Пространство имен:

System.Data.Objects

Сборка:

System.Data.Entity.dll

Явно загружает связанный объект при использовании пользовательских классов данных POCO.

Перегрузки

Имя	Описание
LoadProperty(Object, String)	Явно загружает объект, связанный с предоставленным объектом указанным свойством навигации, и с помощью параметра слияния по умолчанию.
LoadProperty(Object, String, MergeOption)	Явным образом загружает объект, связанный с предоставленным объектом указанным свойством навигации, и с помощью указанного параметра слияния.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Явно загружает объект, связанный с предоставленным объектом заданным запросом LINQ, и с помощью указанного параметра слияния.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Явно загружает объект, связанный с предоставленным объектом указанным запросом LINQ, и с помощью параметра слияния по умолчанию.

Комментарии

При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, например экземпляры типов сущностей, созданных средствами модели данных сущностей. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEnd. Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав LazyLoadingEnabled свойство true для экземпляра ObjectContextOptions , возвращаемого ObjectContext.ContextOptions свойством, или с помощью активной загрузки с Include методом на объекте ObjectQuery<T>.

LoadProperty(Object, String)

Явно загружает объект, связанный с предоставленным объектом указанным свойством навигации, и с помощью параметра слияния по умолчанию.

public:
 void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty);

public void LoadProperty(object entity, string navigationProperty);

member this.LoadProperty : obj * string -> unit

Public Sub LoadProperty (entity As Object, navigationProperty As String)

Параметры

entity

Object

Сущность, для которой загружаются связанные объекты.

navigationProperty

String

Имя свойства навигации, возвращающего загруженные связанные объекты.

Исключения

InvalidOperationException

Находится entity в DetachedAdded состоянии или Deleted в состоянии

–или–

Присоединен entity к другому экземпляру ObjectContext.

Комментарии

Метод LoadProperty должен вызываться для явной загрузки при использовании пользовательских классов данных POCO.

После вызова LoadPropertyсвязанный объект можно получить через свойства навигации исходной сущности.

При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, например экземпляры типов сущностей, созданных средствами модели данных сущностей. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEnd. Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав LazyLoadingEnabled свойство true для экземпляра ObjectContextOptions , возвращаемого ObjectContext.ContextOptions свойством, или с помощью активной загрузки с Include методом на объекте ObjectQuery<T>.

LoadProperty При вызове метода объекты загружаются в объект ObjectContext с помощью значения AppendOnlyпо умолчаниюMergeOption.

LoadProperty(Object, String, MergeOption)

Явным образом загружает объект, связанный с предоставленным объектом указанным свойством навигации, и с помощью указанного параметра слияния.

public:
 void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty, System::Data::Objects::MergeOption mergeOption);

public void LoadProperty(object entity, string navigationProperty, System.Data.Objects.MergeOption mergeOption);

member this.LoadProperty : obj * string * System.Data.Objects.MergeOption -> unit

Public Sub LoadProperty (entity As Object, navigationProperty As String, mergeOption As MergeOption)

Параметры

entity

Object

Сущность, для которой загружаются связанные объекты.

navigationProperty

String

Имя свойства навигации, возвращающего загруженные связанные объекты.

mergeOption

MergeOption

Значение, используемое MergeOption при загрузке связанных объектов.

Исключения

InvalidOperationException

Находится entity в DetachedAdded состоянии или Deleted в состоянии

–или–

Присоединен entity к другому экземпляру ObjectContext.

Комментарии

Метод LoadProperty должен вызываться для явной загрузки при использовании пользовательских классов данных POCO.

После вызова LoadPropertyсвязанный объект можно получить через свойства навигации исходной сущности.

При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, например экземпляры типов сущностей, созданных средствами модели данных сущностей. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEnd. Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав LazyLoadingEnabled свойство true для экземпляра ObjectContextOptions , возвращаемого ObjectContext.ContextOptions свойством, или с помощью активной загрузки с Include методом на объекте ObjectQuery<T>.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)

Явно загружает объект, связанный с предоставленным объектом заданным запросом LINQ, и с помощью указанного параметра слияния.

public:
generic <typename TEntity>
 void LoadProperty(TEntity entity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ selector, System::Data::Objects::MergeOption mergeOption);

public void LoadProperty<TEntity>(TEntity entity, System.Linq.Expressions.Expression<Func<TEntity,object>> selector, System.Data.Objects.MergeOption mergeOption);

member this.LoadProperty : 'Entity * System.Linq.Expressions.Expression<Func<'Entity, obj>> * System.Data.Objects.MergeOption -> unit

Public Sub LoadProperty(Of TEntity) (entity As TEntity, selector As Expression(Of Func(Of TEntity, Object)), mergeOption As MergeOption)

Параметры типа

TEntity

Тип предоставленного объекта.

Параметры

entity

TEntity

Исходный объект, для которого загружаются связанные объекты.

selector

Expression<Func<TEntity,Object>>

Выражение LINQ, определяющее загруженные связанные объекты.

mergeOption

MergeOption

Значение, используемое MergeOption при загрузке связанных объектов.

Исключения

ArgumentException

selector не предоставляет допустимый входной параметр.

ArgumentNullException

Параметр selector имеет значение null.

InvalidOperationException

Находится entity в DetachedAdded состоянии или Deleted в состоянии

–или–

Присоединен entity к другому экземпляру ObjectContext.

Комментарии

Метод LoadProperty должен вызываться для явной загрузки при использовании пользовательских классов данных POCO.

После вызова LoadPropertyсвязанный объект можно получить через свойства навигации исходной сущности.

Свойство для загрузки указывается выражением LINQ, которое должно находиться в виде простого доступа к элементу свойства, как в (entity) => entity.PropertyName том месте, где PropertyName — это свойство навигации, возвращающее связанные объекты для загрузки. Исключение возникает, если используются другие формы выражения LINQ.

При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, например экземпляры типов сущностей, созданных средствами модели данных сущностей. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEnd. Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав LazyLoadingEnabled свойство true для экземпляра ObjectContextOptions , возвращаемого ObjectContext.ContextOptions свойством, или с помощью активной загрузки с Include методом на объекте ObjectQuery<T>.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)

Явно загружает объект, связанный с предоставленным объектом указанным запросом LINQ, и с помощью параметра слияния по умолчанию.

public:
generic <typename TEntity>
 void LoadProperty(TEntity entity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ selector);

public void LoadProperty<TEntity>(TEntity entity, System.Linq.Expressions.Expression<Func<TEntity,object>> selector);

member this.LoadProperty : 'Entity * System.Linq.Expressions.Expression<Func<'Entity, obj>> -> unit

Public Sub LoadProperty(Of TEntity) (entity As TEntity, selector As Expression(Of Func(Of TEntity, Object)))

Параметры типа

TEntity

Тип предоставленного объекта.

Параметры

entity

TEntity

Исходный объект, для которого загружаются связанные объекты.

selector

Expression<Func<TEntity,Object>>

Выражение LINQ, определяющее загруженные связанные объекты.

Исключения

ArgumentException

selector не предоставляет допустимый входной параметр.

ArgumentNullException

Параметр selector имеет значение null.

InvalidOperationException

Находится entity в DetachedAdded состоянии или Deleted в состоянии

–или–

Присоединен entity к другому экземпляру ObjectContext.

Комментарии

Метод LoadProperty должен вызываться для явной загрузки при использовании пользовательских классов данных POCO.

После вызова LoadPropertyсвязанный объект можно получить через свойства навигации исходной сущности.

Свойство для загрузки определяется выражением LINQ, которое должно находиться в виде простого доступа к члену свойства, как в (entity) => entity.PropertyNameтом случае, когда PropertyName — это свойство навигации, возвращающее связанные объекты для загрузки. Исключение возникает, если используются другие формы выражения LINQ.

При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, например экземпляры типов сущностей, созданных средствами модели данных сущностей. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEnd. Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав LazyLoadingEnabled свойство true для экземпляра ObjectContextOptions , возвращаемого ObjectContext.ContextOptions свойством, или с помощью активной загрузки с Include методом на объекте ObjectQuery<T>.