EntityReference<TEntity>, classe

[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]

Modélise une terminaison de relation avec multiplicité 1.

Hiérarchie d'héritage

System.Object
  System.Data.Entity.Core.Objects.DataClasses.RelatedEnd
    System.Data.Entity.Core.Objects.DataClasses.EntityReference
      System.Data.Entity.Core.Objects.DataClasses.EntityReference<TEntity>

Espace de noms :  System.Data.Entity.Core.Objects.DataClasses
Assembly :  EntityFramework (dans EntityFramework.dll)

Syntaxe

'Déclaration
<SerializableAttribute> _
<DataContractAttribute> _
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class EntityReference(Of TEntity As Class) _
    Inherits EntityReference
'Utilisation
Dim instance As EntityReference(Of TEntity)

[SerializableAttribute]
[DataContractAttribute]
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class EntityReference<TEntity> : EntityReference 
where TEntity : class

[SerializableAttribute]
[DataContractAttribute]
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TEntity>
where TEntity : ref class 
public ref class EntityReference : public EntityReference

[<SerializableAttribute>]
[<DataContractAttribute>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type EntityReference<'TEntity when 'TEntity : not struct> =  
    class 
        inherit EntityReference 
    end

JScript does not support generic types and methods.

Paramètres de type

• TEntity
  Type de l'entité référencée.

Le type EntityReference<TEntity> expose les membres suivants.

Constructeurs

	Nom	Description
	EntityReference<TEntity>	Crée une instance de EntityReference<TEntity>.

Top

Propriétés

	Nom	Description
	EntityKey	Retourne la clé de l'objet connexe. (Hérité de EntityReference.)
	IsLoaded	Obtient une valeur qui indique si tous les objets connexes ont été chargés. (Hérité de RelatedEnd.)
	RelationshipName	Obtient le nom de la relation à laquelle cette terminaison connexe participe. (Hérité de RelatedEnd.)
	RelationshipSet	Obtient une référence aux métadonnées de la terminaison connexe. (Hérité de RelatedEnd.)
	SourceRoleName	Obtient le nom du rôle à la terminaison source de la relation. (Hérité de RelatedEnd.)
	TargetRoleName	Obtient le nom du rôle à la terminaison cible de la relation. (Hérité de RelatedEnd.)
	Value	Obtient ou définit l'objet connexe retourné par cet objet EntityReference<TEntity>.

Top

Méthodes

	Nom	Description
	Attach	Crée une relation plusieurs-à-un ou un-à-un entre deux objets dans le contexte de l'objet.
	CreateSourceQuery	Crée une requête d'objet équivalente qui retourne l'objet connexe.
	Equals	(Hérité de Object.)
	Finalize	(Hérité de Object.)
	GetEnumerator	Retourne un objet IEnumerator qui itère au sein de la collection d'objets connexes. (Hérité de RelatedEnd.)
	GetHashCode	(Hérité de Object.)
	GetType	(Hérité de Object.)
	Load()	Charge les objets connexes dans la terminaison connexe avec l'option de fusion par défaut. (Hérité de RelatedEnd.)
	Load(MergeOption)	Charge l'objet connexe pour cet objet EntityReference<TEntity> avec l'option de fusion spécifiée. (Substitue RelatedEnd.Load(MergeOption).)
	LoadAsync(CancellationToken)	Charge les objets connexes de manière asynchrone dans la terminaison connexe avec l'option de fusion par défaut. (Hérité de RelatedEnd.)
	LoadAsync(MergeOption, CancellationToken)	Charge de façon asynchrone l'entité ou les entités associées dans la terminaison connexe locale à l'aide de l'option de fusion par défaut. (Substitue RelatedEnd.LoadAsync(MergeOption, CancellationToken).)
	MemberwiseClone	(Hérité de Object.)
	OnDeserialized	Utilisé en interne pour désérialiser des objets entités avec les instances RelationshipManager. (Hérité de RelatedEnd.)
	OnRefDeserialized	Cette méthode est utilisée en interne pour sérialiser des objets entité associés.
	OnSerializing	Cette méthode est utilisée en interne pour sérialiser des objets entité associés.
	ToString	(Hérité de Object.)

Top

Événements

	Nom	Description
	AssociationChanged	Se produit lorsqu'une modification est apportée à une terminaison connexe. (Hérité de RelatedEnd.)

Top

Implémentations d'interface explicite

	Nom	Description
	IRelatedEnd.Add(Object)	Ajoute une entité à la terminaison connexe.Si le propriétaire est attaché à un cache, toutes les terminaisons connectées sont ajoutées au cache d'objets et leurs relations correspondantes sont également ajoutées à l'objet ObjectStateManager.Le RelatedEnd de la relation est également fixe. (Hérité de RelatedEnd.)
	IRelatedEnd.Add(IEntityWithRelationships)	Ajoute une entité à la terminaison connexe.Cette méthode fonctionne de la même façon que la méthode Add(object).Elle est conservée à des fins de compatibilité descendante avec les versions antérieures de IRelatedEnd. (Hérité de RelatedEnd.)
	IRelatedEnd.Attach(Object)	Attache une entité à la terminaison connexe.Si la terminaison connexe est déjà remplie ou partiellement remplie, la méthode fusionne les entités existantes avec l'entité donnée.Il n'est pas supposé que l'entité donnée est le jeu complet d'entités associées.Le propriétaire et toutes les entités passées doivent être à l'état Unchanged ou Modified.Les éléments supprimés sont autorisés uniquement lorsque le gestionnaire d'état effectue déjà le suivi de l'instance de relation. (Hérité de RelatedEnd.)
	IRelatedEnd.Attach(IEntityWithRelationships)	Attache une entité à la terminaison connexe.Cette méthode fonctionne de la même façon que la méthode Attach(object).Elle est conservée à des fins de compatibilité descendante avec les versions antérieures de IRelatedEnd. (Hérité de RelatedEnd.)
	IRelatedEnd.CreateSourceQuery	Retourne un objet IEnumerable qui représente les objets appartenant à la terminaison connexe. (Hérité de RelatedEnd.)
	IRelatedEnd.Remove(Object)	Supprime une entité de la terminaison connexe.Si le propriétaire est attaché à un cache, marque la relation pour la suppression et si la relation est une relation de composition marque également l'entité pour la suppression. (Hérité de RelatedEnd.)
	IRelatedEnd.Remove(IEntityWithRelationships)	Supprime une entité de la terminaison connexe.Cette méthode fonctionne de la même façon que la méthode Remove(object).Elle est conservée à des fins de compatibilité descendante avec les versions antérieures de IRelatedEnd. (Hérité de RelatedEnd.)

Top

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms System.Data.Entity.Core.Objects.DataClasses