ObjectContext.LoadProperty Método

Definição

Carrega explicitamente um objeto relacionado quando estás a usar classes de dados personalizadas POCO.

Sobrecargas

Name Description
LoadProperty(Object, String)

Carrega explicitamente um objeto relacionado com o objeto fornecido pela propriedade de navegação especificada e usando a opção de fusão por defeito.

LoadProperty(Object, String, MergeOption)

Carrega explicitamente um objeto relacionado com o objeto fornecido pela propriedade de navegação especificada e usando a opção de fusão especificada.

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

Carrega explicitamente um objeto relacionado com o objeto fornecido pela consulta LINQ especificada e usando a opção de fusão especificada.

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

Carrega explicitamente um objeto relacionado com o objeto fornecido pela consulta LINQ especificada e usando a opção de fusão por defeito.

Observações

Ao utilizar classes de dados personalizadas POCO, objetos relacionados não podem ser carregados explicitamente como as instâncias de tipos de entidade geradas pelas ferramentas do Modelo de Dados de Entidade. Isto deve-se ao facto de as ferramentas gerarem 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 carregamento preguiçoso, definindo a LazyLoadingEnabled propriedade como true na instância de ObjectContextOptions que é devolvida pela ObjectContext.ContextOptions propriedade, ou usando carregamento entusiasta com o Include método no ObjectQuery<T>.

LoadProperty(Object, String)

Carrega explicitamente um objeto relacionado com o objeto fornecido pela propriedade de navegação especificada e usando a opção de fusão por defeito.

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 devolve os objetos relacionados a serem carregados.

Exceções

O entity está num Detached, Added ou Deleted estado,

-ou-

O entity está ligado a outra instância de ObjectContext.

Observações

O LoadProperty método deve ser chamado para conseguir carregamento explícito quando se usam classes de dados personalizadas POCO.

Após chamar LoadProperty, o objeto relacionado pode ser acedido através das propriedades de navegação da entidade de origem.

Ao utilizar classes de dados personalizadas POCO, objetos relacionados não podem ser carregados explicitamente como as instâncias de tipos de entidade geradas pelas ferramentas do Modelo de Dados de Entidade. Isto deve-se ao facto de as ferramentas gerarem 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 carregamento preguiçoso, definindo a LazyLoadingEnabled propriedade como true na instância de ObjectContextOptions que é devolvida pela ObjectContext.ContextOptions propriedade, ou usando carregamento entusiasta 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.

Aplica-se a

LoadProperty(Object, String, MergeOption)

Carrega explicitamente um objeto relacionado com o objeto fornecido pela propriedade de navegação especificada e usando a opção de fusão 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 devolve os objetos relacionados a serem carregados.

mergeOption
MergeOption

O MergeOption valor a usar quando carregas os objetos relacionados.

Exceções

O entity está num Detached, Added ou Deleted estado,

-ou-

O entity está ligado a outra instância de ObjectContext.

Observações

O LoadProperty método deve ser chamado para conseguir carregamento explícito quando se usam classes de dados personalizadas POCO.

Após chamar LoadProperty, o objeto relacionado pode ser acedido através das propriedades de navegação da entidade de origem.

Ao utilizar classes de dados personalizadas POCO, objetos relacionados não podem ser carregados explicitamente como as instâncias de tipos de entidade geradas pelas ferramentas do Modelo de Dados de Entidade. Isto deve-se ao facto de as ferramentas gerarem 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 carregamento preguiçoso, definindo a LazyLoadingEnabled propriedade como true na instância de ObjectContextOptions que é devolvida pela ObjectContext.ContextOptions propriedade, ou usando carregamento entusiasta com o Include método no ObjectQuery<T>.

Aplica-se a

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

Carrega explicitamente um objeto relacionado com o objeto fornecido pela consulta LINQ especificada e usando a opção de fusão 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 Genérico

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 carregados.

mergeOption
MergeOption

O MergeOption valor a usar quando carregas os objetos relacionados.

Exceções

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

selector é null.

O entity está num Detached, Added ou Deleted estado,

-ou-

O entity está ligado a outra instância de ObjectContext.

Observações

O LoadProperty método deve ser chamado para conseguir carregamento explícito quando se usam classes de dados personalizadas POCO.

Após chamar LoadProperty, o objeto relacionado pode ser acedido através das propriedades de navegação da entidade de origem.

A propriedade a carregar é especificada por uma expressão LINQ, que deve ser apenas um simples acesso ao membro da propriedade, como em (entity) => entity.PropertyName que PropertyName é a propriedade de navegação que devolve os objetos relacionados a serem carregados. Ocorrerá uma exceção se forem usadas outras formas da expressão LINQ.

Ao utilizar classes de dados personalizadas POCO, objetos relacionados não podem ser carregados explicitamente como as instâncias de tipos de entidade geradas pelas ferramentas do Modelo de Dados de Entidade. Isto deve-se ao facto de as ferramentas gerarem 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 carregamento preguiçoso, definindo a LazyLoadingEnabled propriedade como true na instância de ObjectContextOptions que é devolvida pela ObjectContext.ContextOptions propriedade, ou usando carregamento entusiasta com o Include método no ObjectQuery<T>.

Aplica-se a

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

Carrega explicitamente um objeto relacionado com o objeto fornecido pela consulta LINQ especificada e usando a opção de fusão por defeito.

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 Genérico

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 carregados.

Exceções

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

selector é null.

O entity está num Detached, Added ou Deleted estado,

-ou-

O entity está ligado a outra instância de ObjectContext.

Observações

O LoadProperty método deve ser chamado para conseguir carregamento explícito quando se usam classes de dados personalizadas POCO.

Após chamar LoadProperty, o objeto relacionado pode ser acedido através das propriedades de navegação da entidade de origem.

A propriedade a carregar é especificada por uma expressão LINQ, que deve ser na forma de um simples acesso ao membro da propriedade, como em (entity) => entity.PropertyName, onde PropertyName é a propriedade de navegação que devolve os objetos relacionados a serem carregados. Ocorrerá uma exceção se forem usadas outras formas da expressão LINQ.

Ao utilizar classes de dados personalizadas POCO, objetos relacionados não podem ser carregados explicitamente como as instâncias de tipos de entidade geradas pelas ferramentas do Modelo de Dados de Entidade. Isto deve-se ao facto de as ferramentas gerarem 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 carregamento preguiçoso, definindo a LazyLoadingEnabled propriedade como true na instância de ObjectContextOptions que é devolvida pela ObjectContext.ContextOptions propriedade, ou usando carregamento entusiasta com o Include método no ObjectQuery<T>.

Aplica-se a