ObjectContext.LoadProperty Metoda

Definice

Obor názvů:

System.Data.Objects

Sestavení:

System.Data.Entity.dll

Explicitně načte související objekt, když používáte vlastní datové třídy POCO.

Přetížení

LoadProperty(Object, String)	Explicitně načte objekt související se zadaným objektem pomocí zadané navigační vlastnosti a pomocí výchozí možnosti sloučení.
LoadProperty(Object, String, MergeOption)	Explicitně načte objekt, který se vztahuje k zadanému objektu pomocí zadané navigační vlastnosti a pomocí zadané možnosti sloučení.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Explicitně načte objekt, který se vztahuje k zadanému objektu zadaným dotazem LINQ a pomocí zadané možnosti sloučení.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Explicitně načte objekt, který se vztahuje k zadanému objektu 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 instance typů entit, které jsou generovány nástroji Entity Data Model. Důvodem je to, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity>EntityReference<TEntity> nebo souvisejících objektů, když Load je volána na objektu RelatedEnd. Entity POCO je stále možné načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true u instance ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání pomocí Include metody na ObjectQuery<T>.

LoadProperty(Object, String)

Explicitně načte objekt související se zadaným objektem pomocí zadané navigační vlastnosti a pomocí výchozí možnosti 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é mají být načteny.

Výjimky

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted

-nebo-

Je entity připojen k jiné instanci .ObjectContext

Poznámky

Metoda LoadProperty musí být volána, aby se dosáhlo explicitního načtení při použití vlastních datových tříd POCO.

Po volání LoadPropertyobjektu je možné získat přístup k souvisejícímu objektu 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 instance typů entit, které jsou generovány nástroji Entity Data Model. Důvodem je to, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity>EntityReference<TEntity> nebo souvisejících objektů, když Load je volána na objektu RelatedEnd. Entity POCO je stále možné načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true u instance ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání pomocí Include metody na ObjectQuery<T>.

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

LoadProperty(Object, String, MergeOption)

Explicitně načte objekt, který se vztahuje k zadanému objektu pomocí zadané navigační vlastnosti 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é mají být načteny.

mergeOption

MergeOption

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

Výjimky

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted

-nebo-

Je entity připojen k jiné instanci .ObjectContext

Poznámky

Metoda LoadProperty musí být volána, aby se dosáhlo explicitního načtení při použití vlastních datových tříd POCO.

Po volání LoadPropertyobjektu je možné získat přístup k souvisejícímu objektu 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 instance typů entit, které jsou generovány nástroji Entity Data Model. Důvodem je to, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity>EntityReference<TEntity> nebo souvisejících objektů, když Load je volána na objektu RelatedEnd. Entity POCO je stále možné načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true u instance ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání pomocí Include metody na ObjectQuery<T>.

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

Explicitně načte objekt, který se vztahuje k zadanému objektu 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ý mají být načteny související objekty.

selector

Expression<Func<TEntity,Object>>

Výraz LINQ, který definuje související objekty, které mají být načteny.

mergeOption

MergeOption

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

Výjimky

ArgumentException

selector neposkytuje platný vstupní parametr.

ArgumentNullException

selector má hodnotu null.

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted

-nebo-

Je entity připojen k jiné instanci .ObjectContext

Poznámky

Metoda LoadProperty musí být volána, aby se dosáhlo explicitního načtení při použití vlastních datových tříd POCO.

Po volání LoadPropertyobjektu je možné získat přístup k souvisejícímu objektu 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ě přístupu člena jednoduché vlastnosti, jako v (entity) => entity.PropertyName případě, 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 instance typů entit, které jsou generovány nástroji Entity Data Model. Důvodem je to, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity>EntityReference<TEntity> nebo souvisejících objektů, když Load je volána na objektu RelatedEnd. Entity POCO je stále možné načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true u instance ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání pomocí Include metody na ObjectQuery<T>.

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

Explicitně načte objekt, který se vztahuje k zadanému objektu 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ý mají být načteny související objekty.

selector

Expression<Func<TEntity,Object>>

Výraz LINQ, který definuje související objekty, které mají být načteny.

Výjimky

ArgumentException

selector neposkytuje platný vstupní parametr.

ArgumentNullException

selector má hodnotu null.

InvalidOperationException

Je entity ve Detachedstavu , Added nebo Deleted

-nebo-

Je entity připojen k jiné instanci .ObjectContext

Poznámky

Metoda LoadProperty musí být volána, aby se dosáhlo explicitního načtení při použití vlastních datových tříd POCO.

Po volání LoadPropertyobjektu je možné získat přístup k souvisejícímu objektu 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ě přístupu člena jednoduché 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 instance typů entit, které jsou generovány nástroji Entity Data Model. Důvodem je to, že nástroje generují navigační vlastnosti, které vrací EntityCollection<TEntity>EntityReference<TEntity> nebo souvisejících objektů, když Load je volána na objektu RelatedEnd. Entity POCO je stále možné načíst pomocí opožděného načítání nastavením LazyLoadingEnabled vlastnosti na true u instance ObjectContextOptions , která je vrácena ObjectContext.ContextOptions vlastností, nebo pomocí dychtivého načítání pomocí Include metody na ObjectQuery<T>.