ObjectContext.LoadProperty Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Carrega explicitamente um objeto relacionado quando você está usando classes de dados personalizados POCO.
Sobrecargas
LoadProperty(Object, String) |
Carrega explicitamente um objeto relacionado ao objeto fornecido pela propriedade de navegação especificada e usando a opção de mesclagem padrão. |
LoadProperty(Object, String, MergeOption) |
Carrega explicitamente um objeto relacionado ao objeto fornecido pela propriedade de navegação especificada e usando a opção de mesclagem especificada. |
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) |
Carrega explicitamente um objeto relacionado ao objeto fornecido pela consulta de LINQ especificada e usando a opção de mesclagem especificada. |
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) |
Carrega explicitamente um objeto relacionado ao objeto fornecido pela consulta de LINQ especificada e usando a opção de mesclagem padrão. |
Comentários
Ao usar classes de dados personalizadas poco, os objetos relacionados não podem ser carregados explicitamente como instâncias de tipos de entidade que são gerados pelas ferramentas do Modelo de Dados de Entidade. Isso ocorre porque as ferramentas geram as propriedades de navegação que retornam um EntityCollection<TEntity> ou EntityReference<TEntity> de objetos relacionados quando Load é chamado em um RelatedEnd. As entidades POCO ainda podem ser carregadas usando o carregamento lento definindo a propriedade como true
na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento ansioso com o Include método no ObjectQuery<T>.LazyLoadingEnabled
LoadProperty(Object, String)
Carrega explicitamente um objeto relacionado ao objeto fornecido pela propriedade de navegação especificada e usando a opção de mesclagem padrão.
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)
Parâmetros
- entity
- Object
A entidade para a qual os objetos relacionados devem ser carregados.
- navigationProperty
- String
O nome da propriedade de navegação que retorna os objetos relacionados a serem carregados.
Exceções
O entity
está em um estado Detached, Added ou Deleted,
- ou -
O entity
está anexado à outra instância do ObjectContext.
Comentários
O LoadProperty método deve ser chamado para obter carregamento explícito quando você estiver usando classes de dados personalizadas poco.
Depois de chamar LoadProperty, o objeto relacionado pode ser acessado por meio das propriedades de navegação da entidade de origem.
Ao usar classes de dados personalizadas poco, os objetos relacionados não podem ser carregados explicitamente como instâncias de tipos de entidade que são gerados pelas ferramentas do Modelo de Dados de Entidade. Isso ocorre porque as ferramentas geram as propriedades de navegação que retornam um EntityCollection<TEntity> ou EntityReference<TEntity> de objetos relacionados quando Load é chamado em um RelatedEnd. As entidades POCO ainda podem ser carregadas usando o carregamento lento definindo a propriedade como true
na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento ansioso com o Include método no ObjectQuery<T>.LazyLoadingEnabled
Quando o LoadProperty método é chamado, os objetos são carregados no ObjectContext usando o valor padrão MergeOption de AppendOnly.
Aplica-se a
LoadProperty(Object, String, MergeOption)
Carrega explicitamente um objeto relacionado ao objeto fornecido pela propriedade de navegação especificada e usando a opção de mesclagem especificada.
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)
Parâmetros
- entity
- Object
A entidade para a qual os objetos relacionados devem ser carregados.
- navigationProperty
- String
O nome da propriedade de navegação que retorna os objetos relacionados a serem carregados.
- mergeOption
- MergeOption
O valor de MergeOption a ser usado quando você carrega os objetos relacionados.
Exceções
O entity
está em um estado Detached, Added ou Deleted,
- ou -
O entity
está anexado à outra instância do ObjectContext.
Comentários
O LoadProperty método deve ser chamado para obter carregamento explícito quando você estiver usando classes de dados personalizadas poco.
Depois de chamar LoadProperty, o objeto relacionado pode ser acessado por meio das propriedades de navegação da entidade de origem.
Ao usar classes de dados personalizadas poco, os objetos relacionados não podem ser carregados explicitamente como instâncias de tipos de entidade que são gerados pelas ferramentas do Modelo de Dados de Entidade. Isso ocorre porque as ferramentas geram as propriedades de navegação que retornam um EntityCollection<TEntity> ou EntityReference<TEntity> de objetos relacionados quando Load é chamado em um RelatedEnd. As entidades POCO ainda podem ser carregadas usando o carregamento lento definindo a propriedade como true
na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento ansioso com o Include método no ObjectQuery<T>.LazyLoadingEnabled
Aplica-se a
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)
Carrega explicitamente um objeto relacionado ao objeto fornecido pela consulta de LINQ especificada e usando a opção de mesclagem especificada.
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)
Parâmetros de tipo
- TEntity
O tipo do objeto fornecido.
Parâmetros
- entity
- TEntity
O objeto de origem para o qual os objetos relacionados devem ser carregados.
- selector
- Expression<Func<TEntity,Object>>
Uma expressão LINQ que define os objetos relacionados a serem carregadas.
- mergeOption
- MergeOption
O valor de MergeOption a ser usado quando você carrega os objetos relacionados.
Exceções
selector
não fornece um parâmetro de entrada válido.
selector
é nulo.
O entity
está em um estado Detached, Added ou Deleted,
- ou -
O entity
está anexado à outra instância do ObjectContext.
Comentários
O LoadProperty método deve ser chamado para obter carregamento explícito quando você estiver usando classes de dados personalizadas poco.
Depois de chamar LoadProperty, o objeto relacionado pode ser acessado por meio das propriedades de navegação da entidade de origem.
A propriedade a ser carregada é especificada por uma expressão LINQ, que deve estar na forma de um acesso de membro de propriedade simples, como em (entity) => entity.PropertyName
que PropertyName é a propriedade de navegação que retorna os objetos relacionados a serem carregados. Uma exceção ocorrerá se outras formas da expressão LINQ forem usadas.
Ao usar classes de dados personalizadas poco, os objetos relacionados não podem ser carregados explicitamente como instâncias de tipos de entidade que são gerados pelas ferramentas do Modelo de Dados de Entidade. Isso ocorre porque as ferramentas geram as propriedades de navegação que retornam um EntityCollection<TEntity> ou EntityReference<TEntity> de objetos relacionados quando Load é chamado em um RelatedEnd. As entidades POCO ainda podem ser carregadas usando o carregamento lento definindo a propriedade como true
na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento ansioso com o Include método no ObjectQuery<T>.LazyLoadingEnabled
Aplica-se a
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)
Carrega explicitamente um objeto relacionado ao objeto fornecido pela consulta de LINQ especificada e usando a opção de mesclagem padrão.
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)))
Parâmetros de tipo
- TEntity
O tipo do objeto fornecido.
Parâmetros
- entity
- TEntity
O objeto de origem para o qual os objetos relacionados devem ser carregados.
- selector
- Expression<Func<TEntity,Object>>
Uma expressão LINQ que define os objetos relacionados a serem carregadas.
Exceções
selector
não fornece um parâmetro de entrada válido.
selector
é nulo.
O entity
está em um estado Detached, Added ou Deleted,
- ou -
O entity
está anexado à outra instância do ObjectContext.
Comentários
O LoadProperty método deve ser chamado para obter carregamento explícito quando você estiver usando classes de dados personalizadas poco.
Depois de chamar LoadProperty, o objeto relacionado pode ser acessado por meio das propriedades de navegação da entidade de origem.
A propriedade a ser carregada é especificada por uma expressão LINQ, que deve estar na forma de um acesso de membro de propriedade simples, como em , em (entity) => entity.PropertyName
que PropertyName é a propriedade de navegação que retorna os objetos relacionados a serem carregados. Uma exceção ocorrerá se outras formas da expressão LINQ forem usadas.
Ao usar classes de dados personalizadas poco, os objetos relacionados não podem ser carregados explicitamente como instâncias de tipos de entidade que são gerados pelas ferramentas do Modelo de Dados de Entidade. Isso ocorre porque as ferramentas geram as propriedades de navegação que retornam um EntityCollection<TEntity> ou EntityReference<TEntity> de objetos relacionados quando Load é chamado em um RelatedEnd. As entidades POCO ainda podem ser carregadas usando o carregamento lento definindo a propriedade como true
na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento ansioso com o Include método no ObjectQuery<T>.LazyLoadingEnabled