RelationshipManager Classe

Définition

Utilisé pour effectuer le suivi des relations entre des objets dans le contexte de l'objet.Used to track relationships between objects in the object context.

public ref class RelationshipManager
[System.Serializable]
public class RelationshipManager
type RelationshipManager = class
Public Class RelationshipManager
Héritage
RelationshipManager
Attributs

Exemples

L’exemple de cette rubrique est basé sur le modèle de vente AdventureWorks Sales Model.The example in this topic is based on the AdventureWorks Sales Model. L’exemple ajoute de SalesOrderHeader nouvelles entités à Contact l’entité.The example adds new SalesOrderHeader entities to the Contact entity. Il obtient ensuite toutes les terminaisons connexes Contact de l’entité et affiche le nom de la relation, le nom du rôle source et le nom du rôle cible pour chaque terminaison connexe.Then it gets all related ends from the Contact entity and displays the relationship name, source role name, and target role name for each related end.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    Contact contact = new Contact();

    // Create a new SalesOrderHeader.
    SalesOrderHeader newSalesOrder1 = new SalesOrderHeader();
    // Add SalesOrderHeader to the Contact.
    contact.SalesOrderHeaders.Add(newSalesOrder1);

    // Create another SalesOrderHeader.
    SalesOrderHeader newSalesOrder2 = new SalesOrderHeader();
    // Add SalesOrderHeader to the Contact.
    contact.SalesOrderHeaders.Add(newSalesOrder2);

    // Get all related ends
    IEnumerable<IRelatedEnd> relEnds =
        ((IEntityWithRelationships)contact).RelationshipManager
        .GetAllRelatedEnds();

    foreach (IRelatedEnd relEnd in relEnds)
    {
        Console.WriteLine("Relationship Name: {0}", relEnd.RelationshipName);
        Console.WriteLine("Source Role Name: {0}", relEnd.SourceRoleName);
        Console.WriteLine("Target Role Name: {0}", relEnd.TargetRoleName);
    }
}
Using context As New AdventureWorksEntities()
    Dim contact As New Contact()

    ' Create a new SalesOrderHeader. 
    Dim newSalesOrder1 As New SalesOrderHeader()
    ' Add SalesOrderHeader to the Contact. 
    contact.SalesOrderHeaders.Add(newSalesOrder1)

    ' Create another SalesOrderHeader. 
    Dim newSalesOrder2 As New SalesOrderHeader()
    ' Add SalesOrderHeader to the Contact. 
    contact.SalesOrderHeaders.Add(newSalesOrder2)

    ' Get all related ends 
    Dim relEnds As IEnumerable(Of IRelatedEnd) = DirectCast(contact, IEntityWithRelationships).RelationshipManager.GetAllRelatedEnds()

    For Each relEnd As IRelatedEnd In relEnds
        Console.WriteLine("Relationship Name: {0}", relEnd.RelationshipName)
        Console.WriteLine("Source Role Name: {0}", relEnd.SourceRoleName)
        Console.WriteLine("Target Role Name: {0}", relEnd.TargetRoleName)
    Next
End Using

Remarques

RelationshipManager est utilisé pour effectuer le suivi des relations entre des objets dans un contexte d'objet.RelationshipManager is used to track relationships between objects in an object context. Il existe une instance de la classe RelationshipManager pour chaque relation suivie dans le contexte de l'objet.There is one instance of the RelationshipManager class for each relationship tracked in the object context. Les relations sont définies par des associations dans un modèle conceptuel.Relationships are defined by associations in a conceptual model. Pour plus d’informations, consultez Association, élément (CSDL).For more information, see Association Element (CSDL).

Méthodes

Create(IEntityWithRelationships)

Crée un objet RelationshipManager.Creates a new RelationshipManager object.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetAllRelatedEnds()

Retourne une énumération de toutes les terminaisons connexes gérées par le gestionnaire de relations.Returns an enumeration of all the related ends managed by the relationship manager.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetRelatedCollection<TTargetEntity>(String, String)

Obtient un objet EntityCollection<TEntity> des objets connexes avec le nom de relation et le nom de rôle cible spécifiés.Gets an EntityCollection<TEntity> of related objects with the specified relationship name and target role name.

GetRelatedEnd(String, String)

Retourne EntityCollection<TEntity> ou EntityReference<TEntity> du type correct pour le rôle cible spécifié dans une relation.Returns either an EntityCollection<TEntity> or EntityReference<TEntity> of the correct type for the specified target role in a relationship.

GetRelatedReference<TTargetEntity>(String, String)

Obtient EntityReference<TEntity> pour un objet connexe à l'aide de la combinaison de nom de relation et de nom de rôle cible spécifiée.Gets the EntityReference<TEntity> for a related object by using the specified combination of relationship name and target role name.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeRelatedCollection<TTargetEntity>(String, String, EntityCollection<TTargetEntity>)

Initialise un EntityCollection<TEntity> existant qui a été créé à l’aide du constructeur sans paramètre.Initializes an existing EntityCollection<TEntity> that was created by using the parameterless constructor.

InitializeRelatedReference<TTargetEntity>(String, String, EntityReference<TTargetEntity>)

Initialise un EntityReference<TEntity> existant qui a été créé à l’aide du constructeur sans paramètre.Initializes an existing EntityReference<TEntity> that was created by using the parameterless constructor.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnDeserialized(StreamingContext)

Utilisé en interne pour désérialiser des objets d'entité avec les instances RelationshipManager.Used internally to deserialize entity objects along with the RelationshipManager instances.

OnSerializing(StreamingContext)

Appelée par Object Services pour préparer un objet EntityKey pour la sérialisation binaire avec une relation sérialisée.Called by Object Services to prepare an EntityKey for binary serialization with a serialized relationship.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à