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

Definition

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.

Overloads

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.

Remarks

Lorsque vous utilisez des classes de données personnalisées POCO, les objets connexes ne peut pas être chargées explicitement comme instances de types d’entités qui sont générés par les outils 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. Il s’agit, car les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes lorsque Load est appelée sur un RelatedEnd.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 être chargées à l’aide de chargement différé en définissant le LazyLoadingEnabled propriété true sur l’instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec le Include sur le (méthode)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.

Remarks

Le LoadProperty méthode doit être appelée pour accomplir le 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 avoir appelé LoadProperty, 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 peut pas être chargées explicitement comme instances de types d’entités qui sont générés par les outils 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. Il s’agit, car les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes lorsque Load est appelée sur un RelatedEnd.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 être chargées à l’aide de chargement différé en définissant le LazyLoadingEnabled propriété true sur l’instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec le Include sur le (méthode)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 le LoadProperty est appelée, les objets sont chargés dans le ObjectContext à l’aide de la valeur par défaut MergeOption valeur AppendOnly.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.

Remarks

Le LoadProperty méthode doit être appelée pour accomplir le 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 avoir appelé LoadProperty, 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 peut pas être chargées explicitement comme instances de types d’entités qui sont générés par les outils 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. Il s’agit, car les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes lorsque Load est appelée sur un RelatedEnd.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 être chargées à l’aide de chargement différé en définissant le LazyLoadingEnabled propriété true sur l’instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec le Include sur le (méthode)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

Type Parameters

TEntity

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.

Remarks

Le LoadProperty méthode doit être appelée pour accomplir le 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 avoir appelé LoadProperty, 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 être sous la forme d’un accès au membre de propriété simple, comme dans (entity) => entity.PropertyNamePropertyName 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 produira si d’autres formes de l’expression LINQ sont utilisés.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 peut pas être chargées explicitement comme instances de types d’entités qui sont générés par les outils 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. Il s’agit, car les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes lorsque Load est appelée sur un RelatedEnd.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 être chargées à l’aide de chargement différé en définissant le LazyLoadingEnabled propriété true sur l’instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec le Include sur le (méthode)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)))

Type Parameters

TEntity

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.

Remarks

Le LoadProperty méthode doit être appelée pour accomplir le 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 avoir appelé LoadProperty, 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 être sous la forme d’un accès au membre de propriété simple, comme dans (entity) => entity.PropertyName, 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 produira si d’autres formes de l’expression LINQ sont utilisés.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 peut pas être chargées explicitement comme instances de types d’entités qui sont générés par les outils 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. Il s’agit, car les outils génèrent les propriétés de navigation qui retournent un EntityCollection<TEntity> ou EntityReference<TEntity> d’objets connexes lorsque Load est appelée sur un RelatedEnd.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 être chargées à l’aide de chargement différé en définissant le LazyLoadingEnabled propriété true sur l’instance de ObjectContextOptions qui est retourné par la ObjectContext.ContextOptions propriété, ou en utilisant le chargement hâtif avec le Include sur le (méthode)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>.

Applies to