ObjectContext.LoadProperty Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Charge explicitement un objet associé lorsque vous utilisez des classes de données personnalisées POCO.
Surcharges
| Nom | Description |
|---|---|
| LoadProperty(Object, String) |
Charge explicitement un objet lié à l’objet fourni par la propriété de navigation spécifiée et à l’aide de l’option de fusion par défaut. |
| LoadProperty(Object, String, MergeOption) |
Charge explicitement un objet lié à l’objet fourni par la propriété de navigation spécifiée et à l’aide de l’option de fusion spécifiée. |
| LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) |
Charge explicitement un objet lié à l’objet fourni par la requête LINQ spécifiée et à l’aide de l’option de fusion spécifiée. |
| LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) |
Charge explicitement un objet lié à l’objet fourni par la requête LINQ spécifiée et à l’aide de l’option de fusion par défaut. |
Remarques
Lorsque vous utilisez des classes de données personnalisées POCO, les objets associés ne peuvent pas être chargés explicitement comme des instances de types d’entités 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> des objets connexes lorsqu’ils Load sont appelés sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement différé en définissant la LazyLoadingEnabled propriété true sur l’instance de celle-ci ObjectContextOptions retournée par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement impatient avec la Include méthode sur le ObjectQuery<T>.
LoadProperty(Object, String)
Charge explicitement un objet lié à l’objet fourni par la propriété de navigation spécifiée et à l’aide de l’option de fusion par défaut.
public:
void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty);public void LoadProperty(object entity, string navigationProperty);member this.LoadProperty : obj * string -> unitPublic Sub LoadProperty (entity As Object, navigationProperty As String)Paramètres
- entity
- Object
Entité pour laquelle les objets associés doivent être chargés.
- navigationProperty
- String
Nom de la propriété de navigation qui retourne les objets associés à charger.
Exceptions
Il entity est dans un état ou DeletedAdded dans un Detachedétat.
- ou -
L’objet entity est attaché à 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 l’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 des instances de types d’entités 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> des objets connexes lorsqu’ils Load sont appelés sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement différé en définissant la LazyLoadingEnabled propriété true sur l’instance de celle-ci ObjectContextOptions retournée par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement impatient avec la Include méthode sur le ObjectQuery<T>.
Lorsque la LoadProperty méthode est appelée, les objets sont chargés dans le fichier à l’aide ObjectContext de la valeur par défaut MergeOption de AppendOnly.
S’applique à
LoadProperty(Object, String, MergeOption)
Charge explicitement un objet lié à l’objet fourni par la propriété de navigation spécifiée et à l’aide de l’option de fusion spécifié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 -> unitPublic Sub LoadProperty (entity As Object, navigationProperty As String, mergeOption As MergeOption)Paramètres
- entity
- Object
Entité pour laquelle les objets associés doivent être chargés.
- navigationProperty
- String
Nom de la propriété de navigation qui retourne les objets associés à charger.
- mergeOption
- MergeOption
Valeur MergeOption à utiliser lorsque vous chargez les objets associés.
Exceptions
Il entity est dans un état ou DeletedAdded dans un Detachedétat.
- ou -
L’objet entity est attaché à 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 l’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 des instances de types d’entités 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> des objets connexes lorsqu’ils Load sont appelés sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement différé en définissant la LazyLoadingEnabled propriété true sur l’instance de celle-ci ObjectContextOptions retournée par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement impatient avec la Include méthode sur le ObjectQuery<T>.
S’applique à
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)
Charge explicitement un objet lié à l’objet fourni par la requête LINQ spécifiée et à l’aide de l’option de fusion spécifié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 -> unitPublic 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 associés doivent être chargés.
- selector
- Expression<Func<TEntity,Object>>
Expression LINQ qui définit les objets associés à charger.
- mergeOption
- MergeOption
Valeur MergeOption à utiliser lorsque vous chargez les objets associés.
Exceptions
selector ne fournit pas de paramètre d’entrée valide.
selector a la valeur null.
Il entity est dans un état ou DeletedAdded dans un Detachedétat.
- ou -
L’objet entity est attaché à 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 l’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 être sous la forme d’un accès de membre de propriété simple, comme dans l’emplacement où (entity) => entity.PropertyNamePropertyName est la propriété de navigation qui retourne 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 des instances de types d’entités 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> des objets connexes lorsqu’ils Load sont appelés sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement différé en définissant la LazyLoadingEnabled propriété true sur l’instance de celle-ci ObjectContextOptions retournée par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement impatient avec la Include méthode sur le ObjectQuery<T>.
S’applique à
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)
Charge explicitement un objet lié à l’objet fourni par la requête LINQ spécifiée et à l’aide de l’option de fusion par défaut.
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>> -> unitPublic 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 associés doivent être chargés.
- selector
- Expression<Func<TEntity,Object>>
Expression LINQ qui définit les objets associés à charger.
Exceptions
selector ne fournit pas de paramètre d’entrée valide.
selector a la valeur null.
Il entity est dans un état ou DeletedAdded dans un Detachedétat.
- ou -
L’objet entity est attaché à 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 l’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 être sous la forme d’un accès de membre de propriété simple, comme dans (entity) => entity.PropertyName, où PropertyName est la propriété de navigation qui retourne 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 des instances de types d’entités 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> des objets connexes lorsqu’ils Load sont appelés sur un RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement différé en définissant la LazyLoadingEnabled propriété true sur l’instance de celle-ci ObjectContextOptions retournée par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement impatient avec la Include méthode sur le ObjectQuery<T>.
