This documentation is archived and is not being maintained.

IRelatedEnd Interface

Defines the end of a relationship.

Namespace:  System.Data.Objects.DataClasses
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

'Declaration
Public Interface IRelatedEnd
'Usage
Dim instance As IRelatedEnd

IRelatedEnd defines the requirements for an object that represents an end in an association. This interface is implemented by the RelatedEnd class. RelatedEnd is the base class for the EntityCollection(Of TEntity) and EntityReference(Of TEntity) classes.

The example in this topic is based on the Adventure Works Sales Model, which was generated by the Entity Data Model Wizard.

The following example adds new SalesOrderHeader entities to the Contact entity. 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 advWorksContext As New AdventureWorksEntities
    Dim contact As New Contact
    Dim newSalesOrder1 As New SalesOrderHeader
    contact.SalesOrderHeader.Add(newSalesOrder1)
    Dim newSalesOrder2 As New SalesOrderHeader
    contact.SalesOrderHeader.Add(newSalesOrder2)

    Dim relEnds As IEnumerable(Of IRelatedEnd) = _
        CType(contact, IEntityWithRelationships) _
        .RelationshipManager.GetAllRelatedEnds

    Dim relEnd As IRelatedEnd
    For Each 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)
    Next 
End Using

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5 SP1
Show: