ObjectContext.LoadProperty Metoda

Definice

Obor názvů:

System.Data.Objects

Sestavení:

System.Data.Entity.dll

Explicitně načte související objekt při použití vlastních datových tříd POCO.

Přetížení

Name	Description
LoadProperty(Object, String)	Explicitně načte objekt související se zadaným navigačním objektem a použije výchozí možnost sloučení.
LoadProperty(Object, String, MergeOption)	Explicitně načte objekt, který souvisí se zadaným navigačním objektem a pomocí zadané možnosti sloučení.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Explicitně načte objekt, který souvisí se zadaným dotazem LINQ, a pomocí zadané možnosti sloučení.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Explicitně načte objekt, který souvisí se zadaným dotazem LINQ, a pomocí výchozí možnosti sloučení.

Poznámky

Při použití vlastních datových tříd POCO nelze související objekty explicitně načíst, jako jsou instance typů entit, které jsou generovány nástroji Entity Data Model. Je to proto, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity> nebo EntityReference<TEntity> související objekty, když Load je volána na objektu RelatedEnd. Entity POCO lze stále načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true instanci ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání s metodou IncludeObjectQuery<T>na .

LoadProperty(Object, String)

Explicitně načte objekt související se zadaným navigačním objektem a použije výchozí možnost sloučení.

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)

Parametry

entity

Object

Entita, pro kterou se mají načíst související objekty.

navigationProperty

String

Název navigační vlastnosti, která vrací související objekty, které se mají načíst.

Výjimky

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted ve stavu,

nebo

Je entity připojen k jiné instanci ObjectContext.

Poznámky

Metoda LoadProperty musí být volána k dosažení explicitního načítání při použití vlastních datových tříd POCO.

Po volání LoadPropertylze související objekt získat přístup prostřednictvím navigačních vlastností zdrojové entity.

Při použití vlastních datových tříd POCO nelze související objekty explicitně načíst, jako jsou instance typů entit, které jsou generovány nástroji Entity Data Model. Je to proto, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity> nebo EntityReference<TEntity> související objekty, když Load je volána na objektu RelatedEnd. Entity POCO lze stále načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true instanci ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání s metodou IncludeObjectQuery<T>na .

LoadProperty Při zavolání metody jsou objekty načteny do objektu ObjectContext pomocí výchozí MergeOption hodnoty AppendOnly.

LoadProperty(Object, String, MergeOption)

Explicitně načte objekt, který souvisí se zadaným navigačním objektem a pomocí zadané možnosti sloučení.

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)

Parametry

entity

Object

Entita, pro kterou se mají načíst související objekty.

navigationProperty

String

Název navigační vlastnosti, která vrací související objekty, které se mají načíst.

mergeOption

MergeOption

Hodnota MergeOption , která se má použít při načtení souvisejících objektů.

Výjimky

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted ve stavu,

nebo

Je entity připojen k jiné instanci ObjectContext.

Poznámky

Metoda LoadProperty musí být volána k dosažení explicitního načítání při použití vlastních datových tříd POCO.

Po volání LoadPropertylze související objekt získat přístup prostřednictvím navigačních vlastností zdrojové entity.

Při použití vlastních datových tříd POCO nelze související objekty explicitně načíst, jako jsou instance typů entit, které jsou generovány nástroji Entity Data Model. Je to proto, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity> nebo EntityReference<TEntity> související objekty, když Load je volána na objektu RelatedEnd. Entity POCO lze stále načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true instanci ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání s metodou IncludeObjectQuery<T>na .

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

Explicitně načte objekt, který souvisí se zadaným dotazem LINQ, a pomocí zadané možnosti sloučení.

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)

Parametry typu

TEntity

Typ zadaného objektu.

Parametry

entity

TEntity

Zdrojový objekt, pro který se mají načíst související objekty.

selector

Expression<Func<TEntity,Object>>

Výraz LINQ, který definuje související objekty, které se mají načíst.

mergeOption

MergeOption

Hodnota MergeOption , která se má použít při načtení souvisejících objektů.

Výjimky

ArgumentException

selector nezadává platný vstupní parametr.

ArgumentNullException

selector je null.

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted ve stavu,

nebo

Je entity připojen k jiné instanci ObjectContext.

Poznámky

Metoda LoadProperty musí být volána k dosažení explicitního načítání při použití vlastních datových tříd POCO.

Po volání LoadPropertylze související objekt získat přístup prostřednictvím navigačních vlastností zdrojové entity.

Vlastnost, která se má načíst, je určena výrazem LINQ, který musí být ve formě jednoduchého přístupu člena vlastnosti, jako v (entity) => entity.PropertyName případě PropertyName je navigační vlastnost, která vrací související objekty, které mají být načteny. Pokud se použijí jiné formy výrazu LINQ, dojde k výjimce.

Při použití vlastních datových tříd POCO nelze související objekty explicitně načíst, jako jsou instance typů entit, které jsou generovány nástroji Entity Data Model. Je to proto, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity> nebo EntityReference<TEntity> související objekty, když Load je volána na objektu RelatedEnd. Entity POCO lze stále načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true instanci ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání s metodou IncludeObjectQuery<T>na .

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

Explicitně načte objekt, který souvisí se zadaným dotazem LINQ, a pomocí výchozí možnosti sloučení.

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)))

Parametry typu

TEntity

Typ zadaného objektu.

Parametry

entity

TEntity

Zdrojový objekt, pro který se mají načíst související objekty.

selector

Expression<Func<TEntity,Object>>

Výraz LINQ, který definuje související objekty, které se mají načíst.

Výjimky

ArgumentException

selector nezadává platný vstupní parametr.

ArgumentNullException

selector je null.

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted ve stavu,

nebo

Je entity připojen k jiné instanci ObjectContext.

Poznámky

Metoda LoadProperty musí být volána k dosažení explicitního načítání při použití vlastních datových tříd POCO.

Po volání LoadPropertylze související objekt získat přístup prostřednictvím navigačních vlastností zdrojové entity.

Vlastnost, která se má načíst, je určena výrazem LINQ, který musí být ve formě jednoduchého přístupu člena vlastnosti, jako v (entity) => entity.PropertyName, kde PropertyName je navigační vlastnost, která vrací související objekty, které mají být načteny. Pokud se použijí jiné formy výrazu LINQ, dojde k výjimce.

Při použití vlastních datových tříd POCO nelze související objekty explicitně načíst, jako jsou instance typů entit, které jsou generovány nástroji Entity Data Model. Je to proto, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity> nebo EntityReference<TEntity> související objekty, když Load je volána na objektu RelatedEnd. Entity POCO lze stále načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true instanci ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání s metodou IncludeObjectQuery<T>na .