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 связанные объекты не могут быть загружены явным образом, как экземпляры типов сущностей, созданные средствами модели entity Data Model. Это связано с тем, что средства создают свойства навигации, которые возвращают 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 в состоянии Detached, Added или Deleted.

-или-

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

Комментарии

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

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

При использовании пользовательских классов данных POCO связанные объекты не могут быть загружены явным образом, как экземпляры типов сущностей, созданные средствами модели entity Data Model. Это связано с тем, что средства создают свойства навигации, которые возвращают 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 в состоянии Detached, Added или Deleted.

-или-

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

Комментарии

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

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

При использовании пользовательских классов данных POCO связанные объекты не могут быть загружены явным образом, как экземпляры типов сущностей, созданные средствами модели entity Data Model. Это связано с тем, что средства создают свойства навигации, которые возвращают 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 в состоянии Detached, Added или Deleted.

-или-

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

Комментарии

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

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

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

При использовании пользовательских классов данных POCO связанные объекты не могут быть загружены явным образом, как экземпляры типов сущностей, созданные средствами модели entity Data Model. Это связано с тем, что средства создают свойства навигации, которые возвращают 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 в состоянии Detached, Added или Deleted.

-или-

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

Комментарии

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

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

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

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