ObjectContext.LoadProperty Método

Definição

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

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 geradas 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 LazyLoadingEnabled propriedade como true na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento adiantado com o Include método no ObjectQuery<T>.

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

InvalidOperationException

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 geradas 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 LazyLoadingEnabled propriedade como true na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento adiantado com o Include método no ObjectQuery<T>.

Quando o LoadProperty método é chamado, os objetos são carregados no ObjectContext usando o valor padrão MergeOption de AppendOnly.

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

InvalidOperationException

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 geradas 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 LazyLoadingEnabled propriedade como true na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento adiantado com o Include método no ObjectQuery<T>.

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

ArgumentException

selector não fornece um parâmetro de entrada válido.

ArgumentNullException

selector é nulo.

InvalidOperationException

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 geradas 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 LazyLoadingEnabled propriedade como true na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento adiantado com o Include método no ObjectQuery<T>.

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

ArgumentException

selector não fornece um parâmetro de entrada válido.

ArgumentNullException

selector é nulo.

InvalidOperationException

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.PropertyNameque 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 geradas 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 LazyLoadingEnabled propriedade como true na instância do ObjectContextOptions que é retornada pela ObjectContext.ContextOptions propriedade ou usando o carregamento adiantado com o Include método no ObjectQuery<T>.