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 von benutzerdefinierten 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 eine EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für eine RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem sie verzögertes Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft auf true die instance ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie eager loading mit der Include -Methode auf der ObjectQuery<T>-Methode verwenden.

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 explizites Laden zu erreichen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertyvon kann ü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, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die eine EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für eine RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem sie verzögertes Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft auf true die instance ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie eager loading mit der Include -Methode auf der ObjectQuery<T>-Methode verwenden.

Wenn die LoadProperty -Methode aufgerufen wird, werden Objekte mithilfe des Standardwerts MergeOption von AppendOnlyin geladenObjectContext.

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 explizites Laden zu erreichen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertyvon kann ü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, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die eine EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für eine RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem sie verzögertes Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft auf true die instance ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie eager loading mit der Include -Methode auf der ObjectQuery<T>-Methode verwenden.

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 explizites Laden zu erreichen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertyvon kann ü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 (entity) => entity.PropertyName . B. wobei PropertyName die Navigationseigenschaft ist, die die zu ladenden verknüpften 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, wie Instanzen von Entitätstypen, die von den Entity Data Model-Tools generiert werden. Dies liegt daran, dass die Tools die Navigationseigenschaften generieren, die eine EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für eine RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem sie verzögertes Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft auf true die instance ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie eager loading mit der Include -Methode auf der ObjectQuery<T>-Methode verwenden.

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 explizites Laden zu erreichen, wenn Sie benutzerdefinierte POCO-Datenklassen verwenden.

Nach dem Aufrufen LoadPropertyvon kann ü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 wie in (entity) => entity.PropertyNamevorliegen muss, 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 von benutzerdefinierten 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 eine EntityCollection<TEntity> oder EntityReference<TEntity> von verwandten Objekten zurückgeben, wenn Load für eine RelatedEndaufgerufen wird. POCO-Entitäten können weiterhin geladen werden, indem sie verzögertes Laden verwenden, indem Sie die LazyLoadingEnabled -Eigenschaft auf true die instance ObjectContextOptions festlegen, die von der ObjectContext.ContextOptions -Eigenschaft zurückgegeben wird, oder indem Sie eager loading mit der Include -Methode auf der ObjectQuery<T>-Methode verwenden.