ObjectContext.LoadProperty Méthode

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Charge explicitement un objet connexe lorsque vous utilisez des classes de données personnalisées POCO.

Surcharges

LoadProperty(Object, String)	Charge explicitement, à l'aide de l'option de fusion par défaut, un objet lié à l'objet fourni par la propriété de navigation spécifiée.
LoadProperty(Object, String, MergeOption)	Charge explicitement, à l'aide de l'option de fusion spécifiée, un objet lié à l'objet fourni par la propriété de navigation indiquée.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Charge explicitement, à l'aide de l'option de fusion spécifiée, un objet lié à l'objet fourni par la requête LINQ indiquée.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Charge explicitement, à l'aide de l'option de fusion par défaut, un objet lié à l'objet fourni par la requête LINQ spécifiée.

Remarques

Lorsque vous utilisez des classes de données personnalisées POCO, les objets associés ne peuvent pas être chargés explicitement, comme les instances de types d’entités qui sont générées par les outils Entity Data Model. Cela est dû au fait que les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes quand Load est appelé sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide d’un chargement différé en définissant la LazyLoadingEnabled propriété true sur le instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec la Include méthode sur le ObjectQuery<T>.

LoadProperty(Object, String)

Charge explicitement, à l'aide de l'option de fusion par défaut, un objet lié à l'objet fourni par la propriété de navigation spécifiée.

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)

Paramètres

entity

Object

Entité pour laquelle les objets connexes seront chargés.

navigationProperty

String

Nom de la propriété de navigation qui retourne les objets connexes à charger.

Exceptions

InvalidOperationException

entity est à l'état Detached, Added ou Deleted.

- ou -

entity est joint à une autre instance de ObjectContext.

Remarques

La LoadProperty méthode doit être appelée pour obtenir un chargement explicite lorsque vous utilisez des classes de données personnalisées POCO.

Après avoir appelé LoadProperty, l’objet associé est accessible via les propriétés de navigation de l’entité source.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets associés ne peuvent pas être chargés explicitement, comme les instances de types d’entités qui sont générées par les outils Entity Data Model. Cela est dû au fait que les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes quand Load est appelé sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide d’un chargement différé en définissant la LazyLoadingEnabled propriété true sur le instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec la Include méthode sur le ObjectQuery<T>.

Lorsque la LoadProperty méthode est appelée, les objets sont chargés dans le à l’aide ObjectContext de la valeur par défaut MergeOption de AppendOnly.

LoadProperty(Object, String, MergeOption)

Charge explicitement, à l'aide de l'option de fusion spécifiée, un objet lié à l'objet fourni par la propriété de navigation indiquée.

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)

Paramètres

entity

Object

Entité pour laquelle les objets connexes seront chargés.

navigationProperty

String

Nom de la propriété de navigation qui retourne les objets connexes à charger.

mergeOption

MergeOption

Valeur MergeOption à utiliser lors du chargement des objets connexes.

Exceptions

InvalidOperationException

entity est à l'état Detached, Added ou Deleted.

- ou -

entity est joint à une autre instance de ObjectContext.

Remarques

La LoadProperty méthode doit être appelée pour obtenir un chargement explicite lorsque vous utilisez des classes de données personnalisées POCO.

Après avoir appelé LoadProperty, l’objet associé est accessible via les propriétés de navigation de l’entité source.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets associés ne peuvent pas être chargés explicitement, comme les instances de types d’entités qui sont générées par les outils Entity Data Model. Cela est dû au fait que les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes quand Load est appelé sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide d’un chargement différé en définissant la LazyLoadingEnabled propriété true sur le instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec la Include méthode sur le ObjectQuery<T>.

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

Charge explicitement, à l'aide de l'option de fusion spécifiée, un objet lié à l'objet fourni par la requête LINQ indiquée.

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)

Paramètres de type

TEntity

Type de l'objet fourni.

Paramètres

entity

TEntity

Objet source pour lequel les objets connexes seront chargés.

selector

Expression<Func<TEntity,Object>>

Expression LINQ qui définit les objets connexes à charger.

mergeOption

MergeOption

Valeur MergeOption à utiliser lors du chargement des objets connexes.

Exceptions

ArgumentException

selector ne fournit pas de paramètre d'entrée valide.

ArgumentNullException

selector a la valeur null.

InvalidOperationException

entity est à l'état Detached, Added ou Deleted.

- ou -

entity est joint à une autre instance de ObjectContext.

Remarques

La LoadProperty méthode doit être appelée pour obtenir un chargement explicite lorsque vous utilisez des classes de données personnalisées POCO.

Après avoir appelé LoadProperty, l’objet associé est accessible via les propriétés de navigation de l’entité source.

La propriété à charger est spécifiée par une expression LINQ, qui doit se présenter sous la forme d’un accès membre de propriété simple, comme dans (entity) => entity.PropertyName où PropertyName est la propriété de navigation qui renvoie les objets associés à charger. Une exception se produit si d’autres formes de l’expression LINQ sont utilisées.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets associés ne peuvent pas être chargés explicitement, comme les instances de types d’entités qui sont générées par les outils Entity Data Model. Cela est dû au fait que les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes quand Load est appelé sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide d’un chargement différé en définissant la LazyLoadingEnabled propriété true sur le instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec la Include méthode sur le ObjectQuery<T>.

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

Charge explicitement, à l'aide de l'option de fusion par défaut, un objet lié à l'objet fourni par la requête LINQ spécifiée.

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

Paramètres de type

TEntity

Type de l'objet fourni.

Paramètres

entity

TEntity

Objet source pour lequel les objets connexes seront chargés.

selector

Expression<Func<TEntity,Object>>

Expression LINQ qui définit les objets connexes à charger.

Exceptions

ArgumentException

selector ne fournit pas de paramètre d'entrée valide.

ArgumentNullException

selector a la valeur null.

InvalidOperationException

entity est à l'état Detached, Added ou Deleted.

- ou -

entity est joint à une autre instance de ObjectContext.

Remarques

La LoadProperty méthode doit être appelée pour obtenir un chargement explicite lorsque vous utilisez des classes de données personnalisées POCO.

Après avoir appelé LoadProperty, l’objet associé est accessible via les propriétés de navigation de l’entité source.

La propriété à charger est spécifiée par une expression LINQ, qui doit se présenter sous la forme d’un accès membre de propriété simple, comme dans (entity) => entity.PropertyName, où PropertyName est la propriété de navigation qui renvoie les objets associés à charger. Une exception se produit si d’autres formes de l’expression LINQ sont utilisées.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets associés ne peuvent pas être chargés explicitement, comme les instances de types d’entités qui sont générées par les outils Entity Data Model. Cela est dû au fait que les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes quand Load est appelé sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide d’un chargement différé en définissant la LazyLoadingEnabled propriété true sur le instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec la Include méthode sur le ObjectQuery<T>.