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í

LoadProperty(Object, String)	Explicitně načte objekt související s 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ý souvisí s zadaným objektem 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ý souvisí s zadaným objektem 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> objekty nebo EntityReference<TEntity> související objekty, když Load je volána RelatedEndna . 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í pomocí Include metody na ObjectQuery<T>.

LoadProperty(Object, String)

Explicitně načte objekt související s 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 mají být načteny související objekty.

navigationProperty

String

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

Výjimky

InvalidOperationException

Hodnota entity je ve Detachedstavu , Added nebo Deleted

-nebo-

Objekt entity je připojen k jiné instanci objektu ObjectContext.

Poznámky

Pokud LoadProperty používáte vlastní datové třídy POCO, musí být volána metoda, aby se dosáhlo explicitního načtení.

Po volání LoadPropertylze k souvisejícímu objektu přistupovat 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> objekty nebo EntityReference<TEntity> související objekty, když Load je volána RelatedEndna . 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í 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ý souvisí s zadaným objektem 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 mají být načteny 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čítání souvisejících objektů.

Výjimky

InvalidOperationException

Hodnota entity je ve Detachedstavu , Added nebo Deleted

-nebo-

Objekt entity je připojen k jiné instanci objektu ObjectContext.

Poznámky

Pokud LoadProperty používáte vlastní datové třídy POCO, musí být volána metoda, aby se dosáhlo explicitního načtení.

Po volání LoadPropertylze k souvisejícímu objektu přistupovat 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> objekty nebo EntityReference<TEntity> související objekty, když Load je volána RelatedEndna . 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í 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é se mají načíst.

mergeOption

MergeOption

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

Výjimky

ArgumentException

selector nezadá platný vstupní parametr.

ArgumentNullException

selector je null.

InvalidOperationException

Hodnota entity je ve Detachedstavu , Added nebo Deleted

-nebo-

Objekt entity je připojen k jiné instanci objektu ObjectContext.

Poznámky

Pokud LoadProperty používáte vlastní datové třídy POCO, musí být volána metoda, aby se dosáhlo explicitního načtení.

Po volání LoadPropertylze k souvisejícímu objektu přistupovat 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, stejně 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> objekty nebo EntityReference<TEntity> související objekty, když Load je volána RelatedEndna . 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í pomocí Include metody na ObjectQuery<T>.

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

Explicitně načte objekt, který souvisí s zadaným objektem 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é se mají načíst.

Výjimky

ArgumentException

selector nezadá platný vstupní parametr.

ArgumentNullException

selector je null.

InvalidOperationException

Hodnota entity je ve Detachedstavu , Added nebo Deleted

-nebo-

Objekt entity je připojen k jiné instanci objektu ObjectContext.

Poznámky

Pokud LoadProperty používáte vlastní datové třídy POCO, musí být volána metoda, aby se dosáhlo explicitního načtení.

Po volání LoadPropertylze k souvisejícímu objektu přistupovat 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é se mají načíst. 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> objekty nebo EntityReference<TEntity> související objekty, když Load je volána RelatedEndna . 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í pomocí Include metody na ObjectQuery<T>.