ObjectContext.LoadProperty Methode

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Lädt ein verbundenes Objekt explizit, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Überlädt

LoadProperty(Object, String)	Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen Navigationseigenschaft und unter Verwendung der standardmäßigen Zusammenführungsoption.
LoadProperty(Object, String, MergeOption)	Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen Navigationseigenschaft und unter Verwendung der angegebenen Zusammenführungsoption.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen LINQ-Abfrage und unter Verwendung der angegebenen Zusammenführungsoption.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen LINQ-Abfrage und unter Verwendung der standardmäßigen Zusammenführungsoption.

Hinweise

Bei Verwendung benutzerdefinierter POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für ein RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem Sie das verzögerte Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft true auf für die Instanz von ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie das eifrige Laden mit der Include -Methode für verwenden ObjectQuery<T>.

LoadProperty(Object, String)

Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen Navigationseigenschaft und unter Verwendung der standardmäßigen Zusammenführungsoption.

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 verbundene Objekte geladen werden sollen.

navigationProperty

String

Der Name der Navigationseigenschaft, die die zu ladenden verbundenen Objekte zurückgibt.

Ausnahmen

InvalidOperationException

Das entity-Element ist im Zustand Detached, Added oder Deleted.

- oder -

Das entity-Element ist an eine andere Instanz von ObjectContext angefügt.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um das explizite Laden zu erreichen, 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 benutzerdefinierter POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für ein RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem Sie das verzögerte Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft true auf für die Instanz von ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie das eifrige Laden mit der Include -Methode für verwenden ObjectQuery<T>.

Wenn die LoadProperty -Methode aufgerufen wird, werden Objekte mithilfe des Standardwerts MergeOption in AppendOnlygeladenObjectContext.

LoadProperty(Object, String, MergeOption)

Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen Navigationseigenschaft und unter Verwendung der angegebenen 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 verbundene Objekte geladen werden sollen.

navigationProperty

String

Der Name der Navigationseigenschaft, die die zu ladenden verbundenen Objekte zurückgibt.

mergeOption

MergeOption

Der beim Laden der verbundenen Objekte zu verwendende MergeOption-Wert.

Ausnahmen

InvalidOperationException

Das entity-Element ist im Zustand Detached, Added oder Deleted.

- oder -

Das entity-Element ist an eine andere Instanz von ObjectContext angefügt.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um das explizite Laden zu erreichen, 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 benutzerdefinierter POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für ein RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem Sie das verzögerte Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft true auf für die Instanz von ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie das eifrige Laden mit der Include -Methode für verwenden ObjectQuery<T>.

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

Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen LINQ-Abfrage und unter Verwendung der angegebenen Zusammenführungsoption.

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 verbundene Objekte geladen werden sollen.

selector

Expression<Func<TEntity,Object>>

Ein LINQ-Ausdruck, der die zu ladenden verbundenen Objekte definiert.

mergeOption

MergeOption

Der beim Laden der verbundenen Objekte zu verwendende MergeOption-Wert.

Ausnahmen

ArgumentException

selector gibt keinen gültigen Eingabeparameter zurück.

ArgumentNullException

selector ist NULL.

InvalidOperationException

Das entity-Element ist im Zustand Detached, Added oder Deleted.

- oder -

Das entity-Element ist an eine andere Instanz von ObjectContext angefügt.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um das explizite Laden zu erreichen, 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 in Form eines einfachen Eigenschaftsmemberzugriffs erfolgen muss, z. B (entity) => entity.PropertyName . wobei PropertyName die Navigationseigenschaft ist, die die zugehörigen Objekte zurückgibt, die geladen werden sollen. Eine Ausnahme tritt auf, wenn andere Formen des LINQ-Ausdrucks verwendet werden.

Bei Verwendung benutzerdefinierter POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für ein RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem Sie das verzögerte Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft true auf für die Instanz von ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie das eifrige Laden mit der Include -Methode für verwenden ObjectQuery<T>.

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

Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen LINQ-Abfrage und unter Verwendung der standardmäßigen Zusammenführungsoption.

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 verbundene Objekte geladen werden sollen.

selector

Expression<Func<TEntity,Object>>

Ein LINQ-Ausdruck, der die zu ladenden verbundenen Objekte definiert.

Ausnahmen

ArgumentException

selector gibt keinen gültigen Eingabeparameter zurück.

ArgumentNullException

selector ist NULL.

InvalidOperationException

Das entity-Element ist im Zustand Detached, Added oder Deleted.

- oder -

Das entity-Element ist an eine andere Instanz von ObjectContext angefügt.

Hinweise

Die LoadProperty Methode muss aufgerufen werden, um das explizite Laden zu erreichen, 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 in Form eines einfachen Eigenschaftsmemberzugriffs erfolgen muss, wie in (entity) => entity.PropertyName, wobei PropertyName die Navigationseigenschaft ist, die die zugehörigen Objekte zurückgibt, die geladen werden sollen. Eine Ausnahme tritt auf, wenn andere Formen des LINQ-Ausdrucks verwendet werden.

Bei Verwendung benutzerdefinierter POCO-Datenklassen können verwandte Objekte nicht explizit geladen werden, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die ein EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für ein RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem Sie das verzögerte Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft true auf für die Instanz von ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie das eifrige Laden mit der Include -Methode für verwenden ObjectQuery<T>.