ObjectContext.LoadProperty Methode

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Lädt ein verknüpftes Objekt explizit, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Überlädt

Name	Beschreibung
LoadProperty(Object, String)	Lädt explizit ein Objekt im Zusammenhang mit dem bereitgestellten Objekt durch die angegebene Navigationseigenschaft und verwendet die Standarddruckoption.
LoadProperty(Object, String, MergeOption)	Lädt explizit ein Objekt, das mit dem bereitgestellten Objekt durch die angegebene Navigationseigenschaft verknüpft ist, und verwendet die angegebene Zusammenführungsoption.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Lädt explizit ein Objekt, das mit dem bereitgestellten Objekt durch die angegebene LINQ-Abfrage und mithilfe der angegebenen Zusammenführungsoption verknüpft ist.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Lädt explizit ein Objekt, das mit dem bereitgestellten Objekt durch die angegebene LINQ-Abfrage und mithilfe der Standarddruckoption verknüpft ist.

Hinweise

Bei Verwendung von benutzerdefinierten POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, z. B. Instanzen von Entitätstypen, die von den Entitätsdatenmodelltools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> mehrere verwandte Objekte zurückgeben, wenn Load für ein RelatedEndObjekt aufgerufen wird. POCO-Entitäten können weiterhin mithilfe des faulen Ladens geladen werden, indem sie die LazyLoadingEnabled Eigenschaft true auf die Instanz ObjectContextOptions festlegen, auf die die Eigenschaft von der ObjectContext.ContextOptions Eigenschaft zurückgegeben wird, oder indem Sie eifrig mit der Methode auf der Include .ObjectQuery<T>

LoadProperty(Object, String)

Lädt explizit ein Objekt im Zusammenhang mit dem bereitgestellten Objekt durch die angegebene Navigationseigenschaft und verwendet die Standarddruckoption.

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)

Parameter

entity

Object

Die Entität, für die verwandte Objekte geladen werden sollen.

navigationProperty

String

Der Name der Navigationseigenschaft, die die zugehörigen Objekte zurückgibt, die geladen werden sollen.

Ausnahmen

InvalidOperationException

Das entity ist in einem DetachedOder-Zustand AddedDeleted ,

- oder -

Die entity Datei ist an eine andere Instanz von ObjectContext.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um explizites Laden zu erzielen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertykann über die Navigationseigenschaften der Quellentität auf das zugehörige Objekt zugegriffen werden.

Bei Verwendung von benutzerdefinierten POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, z. B. Instanzen von Entitätstypen, die von den Entitätsdatenmodelltools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> mehrere verwandte Objekte zurückgeben, wenn Load für ein RelatedEndObjekt aufgerufen wird. POCO-Entitäten können weiterhin mithilfe des faulen Ladens geladen werden, indem sie die LazyLoadingEnabled Eigenschaft true auf die Instanz ObjectContextOptions festlegen, auf die die Eigenschaft von der ObjectContext.ContextOptions Eigenschaft zurückgegeben wird, oder indem Sie eifrig mit der Methode auf der Include .ObjectQuery<T>

Wenn die LoadProperty Methode aufgerufen wird, werden ObjectContext Objekte mithilfe des Standardwerts MergeOption von AppendOnly.

LoadProperty(Object, String, MergeOption)

Lädt explizit ein Objekt, das mit dem bereitgestellten Objekt durch die angegebene Navigationseigenschaft verknüpft ist, und verwendet die angegebene Zusammenführungsoption.

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)

Parameter

entity

Object

Die Entität, für die verwandte Objekte geladen werden sollen.

navigationProperty

String

Der Name der Navigationseigenschaft, die die zugehörigen Objekte zurückgibt, die geladen werden sollen.

mergeOption

MergeOption

Der MergeOption Wert, der beim Laden der zugehörigen Objekte verwendet werden soll.

Ausnahmen

InvalidOperationException

Das entity ist in einem DetachedOder-Zustand AddedDeleted ,

- oder -

Die entity Datei ist an eine andere Instanz von ObjectContext.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um explizites Laden zu erzielen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertykann über die Navigationseigenschaften der Quellentität auf das zugehörige Objekt zugegriffen werden.

Bei Verwendung von benutzerdefinierten POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, z. B. Instanzen von Entitätstypen, die von den Entitätsdatenmodelltools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> mehrere verwandte Objekte zurückgeben, wenn Load für ein RelatedEndObjekt aufgerufen wird. POCO-Entitäten können weiterhin mithilfe des faulen Ladens geladen werden, indem sie die LazyLoadingEnabled Eigenschaft true auf die Instanz ObjectContextOptions festlegen, auf die die Eigenschaft von der ObjectContext.ContextOptions Eigenschaft zurückgegeben wird, oder indem Sie eifrig mit der Methode auf der Include .ObjectQuery<T>

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

Lädt explizit ein Objekt, das mit dem bereitgestellten Objekt durch die angegebene LINQ-Abfrage und mithilfe der angegebenen Zusammenführungsoption verknüpft ist.

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)

Typparameter

TEntity

Der Typ des angegebenen Objekts.

Parameter

entity

TEntity

Das Quellobjekt, für das verwandte Objekte geladen werden sollen.

selector

Expression<Func<TEntity,Object>>

Ein LINQ-Ausdruck, der die zu ladenden zugehörigen Objekte definiert.

mergeOption

MergeOption

Der MergeOption Wert, der beim Laden der zugehörigen Objekte verwendet werden soll.

Ausnahmen

ArgumentException

selector gibt keinen gültigen Eingabeparameter an.

ArgumentNullException

selector ist NULL.

InvalidOperationException

Das entity ist in einem DetachedOder-Zustand AddedDeleted ,

- oder -

Die entity Datei ist an eine andere Instanz von ObjectContext.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um explizites Laden zu erzielen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertykann über die Navigationseigenschaften der Quellentität auf das zugehörige Objekt zugegriffen werden.

Die zu ladende Eigenschaft wird durch einen LINQ-Ausdruck angegeben, der sich in Form eines einfachen Eigenschaftsmemempelzugriffs befinden muss, wie in (entity) => entity.PropertyName der PropertyName die Navigationseigenschaft ist, die die zu ladenden zugehörigen Objekte zurückgibt. Eine Ausnahme tritt auf, wenn andere Formen des LINQ-Ausdrucks verwendet werden.

Bei Verwendung von benutzerdefinierten POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, z. B. Instanzen von Entitätstypen, die von den Entitätsdatenmodelltools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> mehrere verwandte Objekte zurückgeben, wenn Load für ein RelatedEndObjekt aufgerufen wird. POCO-Entitäten können weiterhin mithilfe des faulen Ladens geladen werden, indem sie die LazyLoadingEnabled Eigenschaft true auf die Instanz ObjectContextOptions festlegen, auf die die Eigenschaft von der ObjectContext.ContextOptions Eigenschaft zurückgegeben wird, oder indem Sie eifrig mit der Methode auf der Include .ObjectQuery<T>

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

Lädt explizit ein Objekt, das mit dem bereitgestellten Objekt durch die angegebene LINQ-Abfrage und mithilfe der Standarddruckoption verknüpft ist.

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

Typparameter

TEntity

Der Typ des angegebenen Objekts.

Parameter

entity

TEntity

Das Quellobjekt, für das verwandte Objekte geladen werden sollen.

selector

Expression<Func<TEntity,Object>>

Ein LINQ-Ausdruck, der die zu ladenden zugehörigen Objekte definiert.

Ausnahmen

ArgumentException

selector gibt keinen gültigen Eingabeparameter an.

ArgumentNullException

selector ist NULL.

InvalidOperationException

Das entity ist in einem DetachedOder-Zustand AddedDeleted ,

- oder -

Die entity Datei ist an eine andere Instanz von ObjectContext.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um explizites Laden zu erzielen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertykann über die Navigationseigenschaften der Quellentität auf das zugehörige Objekt zugegriffen werden.

Die zu ladende Eigenschaft wird durch einen LINQ-Ausdruck angegeben, der sich in Form eines einfachen Eigenschaftsmemembezugriffs befinden muss, wie in (entity) => entity.PropertyName"PropertyName" die Navigationseigenschaft, die die zu ladenden zugehörigen Objekte zurückgibt. Eine Ausnahme tritt auf, wenn andere Formen des LINQ-Ausdrucks verwendet werden.

Bei Verwendung von benutzerdefinierten POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, z. B. Instanzen von Entitätstypen, die von den Entitätsdatenmodelltools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> mehrere verwandte Objekte zurückgeben, wenn Load für ein RelatedEndObjekt aufgerufen wird. POCO-Entitäten können weiterhin mithilfe des faulen Ladens geladen werden, indem sie die LazyLoadingEnabled Eigenschaft true auf die Instanz ObjectContextOptions festlegen, auf die die Eigenschaft von der ObjectContext.ContextOptions Eigenschaft zurückgegeben wird, oder indem Sie eifrig mit der Methode auf der Include .ObjectQuery<T>