ObjectContext.LoadProperty ObjectContext.LoadProperty ObjectContext.LoadProperty ObjectContext.LoadProperty Method

Définition

Charge explicitement un objet connexe lorsque vous utilisez des classes de données personnalisées POCO.Explicitly loads a related object when you are using POCO custom data classes.

Surcharges

LoadProperty(Object, String) LoadProperty(Object, String) LoadProperty(Object, String) 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.Explicitly loads an object related to the supplied object by the specified navigation property and using the default merge option.

LoadProperty(Object, String, MergeOption) LoadProperty(Object, String, MergeOption) 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.Explicitly loads an object that is related to the supplied object by the specified navigation property and using the specified merge option.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) 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.Explicitly loads an object that is related to the supplied object by the specified LINQ query and by using the specified merge option.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) 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.Explicitly loads an object that is related to the supplied object by the specified LINQ query and by using the default merge option.

Remarques

Lorsque vous utilisez des classes de données personnalisées POCO, les objets connexes ne peuvent pas être chargés explicitement comme des instances de types d’entité générés par les outils de Entity Data Model.When using POCO custom data classes, related objects cannot be explicitly loaded like instances of entity types that are generated by the Entity Data Model tools. Cela est dû au fait que les outils génèrent les propriétés EntityCollection<TEntity> de EntityReference<TEntity> navigation qui retournent un ou des RelatedEndobjets connexes lorsque Load est appelé sur un.This is because the tools generate the navigation properties that return an EntityCollection<TEntity> or EntityReference<TEntity> of related objects when Load is called on a RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement LazyLoadingEnabled différé en true affectant à la ObjectContextOptions propriété la valeur sur l' ObjectContext.ContextOptions instance de qui est retournée par la propriété Include , ou en utilisant le chargement hâtif avec la méthode sur le ObjectQuery<T>.POCO entities can still be loaded by using lazy loading by setting the LazyLoadingEnabled property to true on the instance of ObjectContextOptions that is returned by the ObjectContext.ContextOptions property, or by using eager loading with the Include method on the ObjectQuery<T>.

LoadProperty(Object, String) LoadProperty(Object, String) LoadProperty(Object, String) 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.Explicitly loads an object related to the supplied object by the specified navigation property and using the default merge option.

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

Entité pour laquelle les objets connexes seront chargés.The entity for which related objects are to be loaded.

navigationProperty
String String String String

Nom de la propriété de navigation qui retourne les objets connexes à charger.The name of the navigation property that returns the related objects to be loaded.

Exceptions

entity est à l'état Detached, Added ou Deleted.The entity is in a Detached, Added or Deleted state, ou-or- entity est joint à une autre instance de ObjectContext.The entity is attached to another instance of 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.The LoadProperty method must be called to achieve explicit loading when you are using POCO custom data classes.

Après l' LoadPropertyappel de, l’objet connexe est accessible via les propriétés de navigation de l’entité source.After calling LoadProperty, the related object can be accessed through the navigation properties of the source entity.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets connexes ne peuvent pas être chargés explicitement comme des instances de types d’entité générés par les outils de Entity Data Model.When using POCO custom data classes, related objects cannot be explicitly loaded like instances of entity types that are generated by the Entity Data Model tools. Cela est dû au fait que les outils génèrent les propriétés EntityCollection<TEntity> de EntityReference<TEntity> navigation qui retournent un ou des RelatedEndobjets connexes lorsque Load est appelé sur un.This is because the tools generate the navigation properties that return an EntityCollection<TEntity> or EntityReference<TEntity> of related objects when Load is called on a RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement LazyLoadingEnabled différé en true affectant à la ObjectContextOptions propriété la valeur sur l' ObjectContext.ContextOptions instance de qui est retournée par la propriété Include , ou en utilisant le chargement hâtif avec la méthode sur le ObjectQuery<T>.POCO entities can still be loaded by using lazy loading by setting the LazyLoadingEnabled property to true on the instance of ObjectContextOptions that is returned by the ObjectContext.ContextOptions property, or by using eager loading with the Include method on the ObjectQuery<T>.

Lorsque la LoadProperty méthode est appelée, les objets sont chargés dans ObjectContext le en utilisant la MergeOption valeur par AppendOnlydéfaut de.When the LoadProperty method is called, objects are loaded into the ObjectContext by using the default MergeOption value of AppendOnly.

LoadProperty(Object, String, MergeOption) LoadProperty(Object, String, MergeOption) 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.Explicitly loads an object that is related to the supplied object by the specified navigation property and using the specified merge option.

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

Paramètres

entity
Object Object Object Object

Entité pour laquelle les objets connexes seront chargés.The entity for which related objects are to be loaded.

navigationProperty
String String String String

Nom de la propriété de navigation qui retourne les objets connexes à charger.The name of the navigation property that returns the related objects to be loaded.

mergeOption
MergeOption MergeOption MergeOption MergeOption

Valeur MergeOption à utiliser lors du chargement des objets connexes.The MergeOption value to use when you load the related objects.

Exceptions

entity est à l'état Detached, Added ou Deleted.The entity is in a Detached, Added or Deleted state, - ou --or- entity est joint à une autre instance de ObjectContext.The entity is attached to another instance of 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.The LoadProperty method must be called to achieve explicit loading when you are using POCO custom data classes.

Après l' LoadPropertyappel de, l’objet connexe est accessible via les propriétés de navigation de l’entité source.After calling LoadProperty, the related object can be accessed through the navigation properties of the source entity.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets connexes ne peuvent pas être chargés explicitement comme des instances de types d’entité générés par les outils de Entity Data Model.When using POCO custom data classes, related objects cannot be explicitly loaded like instances of entity types that are generated by the Entity Data Model tools. Cela est dû au fait que les outils génèrent les propriétés EntityCollection<TEntity> de EntityReference<TEntity> navigation qui retournent un ou des RelatedEndobjets connexes lorsque Load est appelé sur un.This is because the tools generate the navigation properties that return an EntityCollection<TEntity> or EntityReference<TEntity> of related objects when Load is called on a RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement LazyLoadingEnabled différé en true affectant à la ObjectContextOptions propriété la valeur sur l' ObjectContext.ContextOptions instance de qui est retournée par la propriété Include , ou en utilisant le chargement hâtif avec la méthode sur le ObjectQuery<T>.POCO entities can still be loaded by using lazy loading by setting the LazyLoadingEnabled property to true on the instance of ObjectContextOptions that is returned by the ObjectContext.ContextOptions property, or by using eager loading with the Include method on the ObjectQuery<T>.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) 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.Explicitly loads an object that is related to the supplied object by the specified LINQ query and by using the specified merge option.

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

Paramètres de type

TEntity

Type de l'objet fourni.The type of the supplied object.

Paramètres

entity
TEntity TEntity TEntity TEntity

Objet source pour lequel les objets connexes seront chargés.The source object for which related objects are to be loaded.

selector
Expression<Func<TEntity,Object>>

Expression LINQ qui définit les objets connexes à charger.A LINQ expression that defines the related objects to be loaded.

mergeOption
MergeOption MergeOption MergeOption MergeOption

Valeur MergeOption à utiliser lors du chargement des objets connexes.The MergeOption value to use when you load the related objects.

Exceptions

selector ne fournit pas de paramètre d'entrée valide.selector does not supply a valid input parameter.

entity est à l'état Detached, Added ou Deleted.The entity is in a Detached, Added or Deleted state, - ou --or- entity est joint à une autre instance de ObjectContext.The entity is attached to another instance of 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.The LoadProperty method must be called to achieve explicit loading when you are using POCO custom data classes.

Après l' LoadPropertyappel de, l’objet connexe est accessible via les propriétés de navigation de l’entité source.After calling LoadProperty, the related object can be accessed through the navigation properties of the source entity.

La propriété à charger est spécifiée par une expression LINQ, qui doit se présenter sous la forme d’un accès aux membres de propriété simple (entity) => entity.PropertyName , comme dans où PropertyName est la propriété de navigation qui retourne les objets connexes à charger.The property to load is specified by a LINQ expression, which must be in the form of a simple property member access, as in (entity) => entity.PropertyName where PropertyName is the navigation property that returns the related objects to be loaded. Une exception se produit si d’autres formes de l’expression LINQ sont utilisées.An exception will occur if other forms of the LINQ expression are used.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets connexes ne peuvent pas être chargés explicitement comme des instances de types d’entité générés par les outils de Entity Data Model.When using POCO custom data classes, related objects cannot be explicitly loaded like instances of entity types that are generated by the Entity Data Model tools. Cela est dû au fait que les outils génèrent les propriétés EntityCollection<TEntity> de EntityReference<TEntity> navigation qui retournent un ou des RelatedEndobjets connexes lorsque Load est appelé sur un.This is because the tools generate the navigation properties that return an EntityCollection<TEntity> or EntityReference<TEntity> of related objects when Load is called on a RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement LazyLoadingEnabled différé en true affectant à la ObjectContextOptions propriété la valeur sur l' ObjectContext.ContextOptions instance de qui est retournée par la propriété Include , ou en utilisant le chargement hâtif avec la méthode sur le ObjectQuery<T>.POCO entities can still be loaded by using lazy loading by setting the LazyLoadingEnabled property to true on the instance of ObjectContextOptions that is returned by the ObjectContext.ContextOptions property, or by using eager loading with the Include method on the ObjectQuery<T>.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) 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.Explicitly loads an object that is related to the supplied object by the specified LINQ query and by using the default merge option.

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.The type of the supplied object.

Paramètres

entity
TEntity TEntity TEntity TEntity

Objet source pour lequel les objets connexes seront chargés.The source object for which related objects are to be loaded.

selector
Expression<Func<TEntity,Object>>

Expression LINQ qui définit les objets connexes à charger.A LINQ expression that defines the related objects to be loaded.

Exceptions

selector ne fournit pas de paramètre d'entrée valide.selector does not supply a valid input parameter.

entity est à l'état Detached, Added ou Deleted.The entity is in a Detached, Added or Deleted state, - ou --or- entity est joint à une autre instance de ObjectContext.The entity is attached to another instance of 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.The LoadProperty method must be called to achieve explicit loading when you are using POCO custom data classes.

Après l' LoadPropertyappel de, l’objet connexe est accessible via les propriétés de navigation de l’entité source.After calling LoadProperty, the related object can be accessed through the navigation properties of the source entity.

La propriété à charger est spécifiée par une expression LINQ, qui doit se présenter sous la forme d’un accès aux membres de propriété simple (entity) => entity.PropertyName, comme dans, où PropertyName est la propriété de navigation qui retourne les objets connexes à charger.The property to load is specified by a LINQ expression, which must be in the form of a simple property member access, as in (entity) => entity.PropertyName, where PropertyName is the navigation property that returns the related objects to be loaded. Une exception se produit si d’autres formes de l’expression LINQ sont utilisées.An exception will occur if other forms of the LINQ expression are used.

Lorsque vous utilisez des classes de données personnalisées POCO, les objets connexes ne peuvent pas être chargés explicitement comme des instances de types d’entité générés par les outils de Entity Data Model.When using POCO custom data classes, related objects cannot be explicitly loaded like instances of entity types that are generated by the Entity Data Model tools. Cela est dû au fait que les outils génèrent les propriétés EntityCollection<TEntity> de EntityReference<TEntity> navigation qui retournent un ou des RelatedEndobjets connexes lorsque Load est appelé sur un.This is because the tools generate the navigation properties that return an EntityCollection<TEntity> or EntityReference<TEntity> of related objects when Load is called on a RelatedEnd. Les entités POCO peuvent toujours être chargées à l’aide du chargement LazyLoadingEnabled différé en true affectant à la ObjectContextOptions propriété la valeur sur l' ObjectContext.ContextOptions instance de qui est retournée par la propriété Include , ou en utilisant le chargement hâtif avec la méthode sur le ObjectQuery<T>.POCO entities can still be loaded by using lazy loading by setting the LazyLoadingEnabled property to true on the instance of ObjectContextOptions that is returned by the ObjectContext.ContextOptions property, or by using eager loading with the Include method on the ObjectQuery<T>.

S’applique à