EntityReference<TEntity> Classe

Définition

Espace de noms:

System.Data.Objects.DataClasses

Assembly:

System.Data.Entity.dll

Représente une fin associée d’une association avec une multiplicité de zéro ou une.

generic <typename TEntity>
 where TEntity : classpublic ref class EntityReference sealed : System::Data::Objects::DataClasses::EntityReference

[System.Runtime.Serialization.DataContract]
[System.Serializable]
public sealed class EntityReference<TEntity> : System.Data.Objects.DataClasses.EntityReference where TEntity : class

[<System.Runtime.Serialization.DataContract>]
[<System.Serializable>]
type EntityReference<'Entity (requires 'Entity : null)> = class
    inherit EntityReference

Public NotInheritable Class EntityReference(Of TEntity)
Inherits EntityReference

Paramètres de type

TEntity

Type d’entité de la référence.

Héritage

Object

RelatedEnd

EntityReference

EntityReference<TEntity>

Attributs

DataContractAttribute SerializableAttribute

Exemples

Cet exemple montre comment utiliser l’objet EntityReference<TEntity> pour modifier une relation entre un SalesOrderHeader objet et un objet associé Address qui représente l’adresse d’expédition de la commande.

// Define the order and new address IDs.
int orderId = 43669;
int addressId = 26;

using (AdventureWorksEntities context
    = new AdventureWorksEntities())
{
    // Get the billing address to change to.
    Address address =
        context.Addresses.Single(c => c.AddressID == addressId);

    // Get the order being changed.
    SalesOrderHeader order =
        context.SalesOrderHeaders.Single(o => o.SalesOrderID == orderId);

    // You do not have to call the Load method to load the addresses for the order,
    // because  lazy loading is set to true
    // by the constructor of the AdventureWorksEntities object.
    // With  lazy loading set to true the related objects are loaded when
    // you access the navigation property. In this case Address.

    // Write the current billing street address.
    Console.WriteLine("Current street: "
        + order.Address.AddressLine1);

    // Change the billing address.
    if (!order.Address.Equals(address))
    {
        // Use Address navigation property to change the association.
        order.Address = address;

        // Write the changed billing street address.
        Console.WriteLine("Changed street: "
            + order.Address.AddressLine1);
    }

    // If the address change succeeds, save the changes.
    context.SaveChanges();

    // Write the current billing street address.
    Console.WriteLine("Current street: "
        + order.Address.AddressLine1);
}

Remarques

Un EntityReference<TEntity> objet est retourné par une propriété de navigation lorsque la fin associée a une multiplicité de zéro ou une. Pour plus d’informations, consultez NavigationProperty, élément (CSDL) .

Un EntityReference<TEntity> objet peut avoir une relation correspondante EntityCollection<TEntity> (un-à-plusieurs) ou EntityReference<TEntity> (relation un-à-un) à l’autre extrémité de la relation. Lorsqu’un EntityReference<TEntity> modèle et une EntityCollection<TEntity> fin de modèle opposés à la même relation, l’intégrité de la relation est conservée au niveau de l’objet.

Cette classe ne peut pas être héritée.

Constructeurs

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

Propriétés

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

Méthodes

Nom	Description
Attach(TEntity)	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 associé.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un itération qui effectue une IEnumerator itération dans la collection d’objets associés. (Hérité de RelatedEnd)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Load()	En cas de substitution dans une classe dérivée, charge l’objet ou les objets associés à la fin associée avec l’option de fusion par défaut. (Hérité de RelatedEnd)
Load(MergeOption)	Charge l’objet associé pour cela EntityReference<TEntity> avec l’option de fusion spécifiée.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserialized(StreamingContext)	Utilisé en interne pour désérialiser des objets d’entité avec les RelationshipManager instances. (Hérité de RelatedEnd)
OnRefDeserialized(StreamingContext)	Cette méthode est utilisée en interne pour sérialiser les objets d’entité associés.
OnSerializing(StreamingContext)	Cette méthode est utilisée en interne pour sérialiser les objets d’entité associés.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Événements

Nom	Description
AssociationChanged	Se produit lorsqu’une modification est apportée à une fin associée. (Hérité de RelatedEnd)

Implémentations d’interfaces explicites

Nom	Description
IRelatedEnd.Add(IEntityWithRelationships)	Ajoute un objet à la fin associée. (Hérité de RelatedEnd)
IRelatedEnd.Add(Object)	Ajoute un objet à la fin associée. (Hérité de RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)	Attache un objet à la fin associée. (Hérité de RelatedEnd)
IRelatedEnd.Attach(Object)	Attache un objet à la fin associée. (Hérité de RelatedEnd)
IRelatedEnd.CreateSourceQuery()	Retourne un IEnumerable qui représente les objets qui appartiennent à la fin associée. (Hérité de RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)	Supprime un objet de la collection à la fin associée. (Hérité de RelatedEnd)
IRelatedEnd.Remove(Object)	Supprime un objet de la fin associée si l’objet fait partie de la fin associée. (Hérité de RelatedEnd)