ObjectContext.LoadProperty Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Явным образом загружает связанный объект при использовании пользовательских классов данных 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 по-прежнему можно загрузить с помощью отложенной загрузки, задав свойству значение LazyLoadingEnabledtrue
в экземпляре 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
Имя свойства навигации, возвращающего связанные объекты для загрузки.
Исключения
Параметр entity
в состоянии Detached, Added или Deleted.
-или-
Если entity
присоединен к другому экземпляру ObjectContext.
Комментарии
Метод LoadProperty должен вызываться для явной загрузки при использовании пользовательских классов данных POCO.
После вызова LoadPropertyсвязанный объект можно получить через свойства навигации исходной сущности.
При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, как экземпляры типов сущностей, созданные средствами модели entity Data Model. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEndдля . Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав свойству значение LazyLoadingEnabledtrue
в экземпляре 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, используемое при загрузке связанных объектов.
Исключения
Параметр entity
в состоянии Detached, Added или Deleted.
-или-
Если entity
присоединен к другому экземпляру ObjectContext.
Комментарии
Метод LoadProperty должен вызываться для явной загрузки при использовании пользовательских классов данных POCO.
После вызова LoadPropertyсвязанный объект можно получить через свойства навигации исходной сущности.
При использовании пользовательских классов данных POCO связанные объекты не могут быть явно загружены, как экземпляры типов сущностей, созданные средствами модели entity Data Model. Это связано с тем, что средства создают свойства навигации, возвращающие EntityCollection<TEntity> или EntityReference<TEntity> связанные объекты при Load вызове RelatedEndдля . Сущности POCO по-прежнему можно загрузить с помощью отложенной загрузки, задав свойству значение LazyLoadingEnabledtrue
в экземпляре 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, используемое при загрузке связанных объектов.
Исключения
selector
не поддерживает допустимый входной параметр.
Параметр selector
имеет значение null.
Параметр 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 по-прежнему можно загрузить с помощью отложенной загрузки, задав свойству значение LazyLoadingEnabledtrue
в экземпляре 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, определяющее связанные объекты для загрузки.
Исключения
selector
не поддерживает допустимый входной параметр.
Параметр selector
имеет значение null.
Параметр 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 по-прежнему можно загрузить с помощью отложенной загрузки, задав свойству значение LazyLoadingEnabledtrue
в экземпляре ObjectContextOptions объекта , возвращаемом свойством ObjectContext.ContextOptions , или с помощью неотложной загрузки с Include методом в ObjectQuery<T>.