IRelatedEnd IRelatedEnd IRelatedEnd IRelatedEnd Interface

Definizione

Definisce l'entità finale di una relazione.Defines the end of a relationship.

public interface class IRelatedEnd
public interface IRelatedEnd
type IRelatedEnd = interface
Public Interface IRelatedEnd
Derivato

Esempi

L'esempio in questo argomento si basa sul modello Sales di AdventureWorks, che è stato generato dal Entity Data Model Wizard.The example in this topic is based on the AdventureWorks Sales Model, which was generated by the Entity Data Model Wizard.

Nell'esempio seguente vengono aggiunte nuove SalesOrderHeader entità al Contact entità.The following example adds new SalesOrderHeader entities to the Contact entity. Vengono quindi ottenute tutte le relative entità finali dalla Contact nome relazione di entità e viene visualizzato, nome del ruolo di origine e nome del ruolo di destinazione per ogni entità finale correlata.Then it gets all related ends from the Contact entity and displays 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

Commenti

IRelatedEnd definisce i requisiti per un oggetto che rappresenta un'entità finale in un'associazione.IRelatedEnd defines the requirements for an object that represents an end in an association. Questa interfaccia viene implementata dal RelatedEnd classe.This interface is implemented by the RelatedEnd class. RelatedEnd è la classe base per il EntityCollection<TEntity> e EntityReference<TEntity> classi.RelatedEnd is the base class for the EntityCollection<TEntity> and EntityReference<TEntity> classes.

Proprietà

IsLoaded IsLoaded IsLoaded IsLoaded

Ottiene un valore che indica se sono stati caricati tutti gli oggetti correlati.Gets a value that indicates whether all related objects have been loaded.

RelationshipName RelationshipName RelationshipName RelationshipName

Ottiene il nome della relazione di cui fa parte l'entità finale correlata.Gets the name of the relationship in which this related end participates.

RelationshipSet RelationshipSet RelationshipSet RelationshipSet

Restituisce un riferimento ai metadati per l'entità finale correlata.Returns a reference to the metadata for the related end.

SourceRoleName SourceRoleName SourceRoleName SourceRoleName

Ottiene il nome del ruolo nell'entità finale di origine della relazione.Gets the role name at the source end of the relationship.

TargetRoleName TargetRoleName TargetRoleName TargetRoleName

Ottiene il nome del ruolo nell'entità finale di destinazione della relazione.Gets the role name at the target end of the relationship.

Metodi

Add(IEntityWithRelationships) Add(IEntityWithRelationships) Add(IEntityWithRelationships) Add(IEntityWithRelationships)

Aggiunge un oggetto all'entità finale correlata.Adds an object to the related end.

Add(Object) Add(Object) Add(Object) Add(Object)

Aggiunge un oggetto all'entità finale correlata.Adds an object to the related end.

Attach(IEntityWithRelationships) Attach(IEntityWithRelationships) Attach(IEntityWithRelationships) Attach(IEntityWithRelationships)

Definisce una relazione tra due oggetti collegati.Defines a relationship between two attached objects.

Attach(Object) Attach(Object) Attach(Object) Attach(Object)

Definisce una relazione tra due oggetti collegati.Defines a relationship between two attached objects.

CreateSourceQuery() CreateSourceQuery() CreateSourceQuery() CreateSourceQuery()

Restituisce un oggetto IEnumerable che rappresenta gli oggetti appartenenti all'entità finale correlata.Returns an IEnumerable that represents the objects that belong to the related end.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Restituisce un oggetto IEnumerator con cui è possibile scorrere l'insieme di oggetti correlati.Returns an IEnumerator that iterates through the collection of related objects.

Load() Load() Load() Load()

Carica l'oggetto o gli oggetti correlati in tale entità finale correlata con l'opzione di unione predefinita.Loads the related object or objects into this related end with the default merge option.

Load(MergeOption) Load(MergeOption) Load(MergeOption) Load(MergeOption)

Carica l'oggetto o gli oggetti correlati nell'entità finale correlata con l'opzione di unione specificata.Loads the related object or objects into the related end with the specified merge option.

Remove(IEntityWithRelationships) Remove(IEntityWithRelationships) Remove(IEntityWithRelationships) Remove(IEntityWithRelationships)

Rimuove un oggetto dall'insieme di oggetti nell'entità finale correlata.Removes an object from the collection of objects at the related end.

Remove(Object) Remove(Object) Remove(Object) Remove(Object)

Rimuove un oggetto dall'insieme di oggetti nell'entità finale correlata.Removes an object from the collection of objects at the related end.

Si applica a