IRelatedEnd 介面

定義

命名空間:

System.Data.Objects.DataClasses

組件:

System.Data.Entity.dll

定義關聯性 (Relationship) 的一端。

public interface class IRelatedEnd

public interface IRelatedEnd

type IRelatedEnd = interface

Public Interface IRelatedEnd

衍生

System.Data.Objects.DataClasses.RelatedEnd

範例

下列範例會將新的 SalesOrderHeader 實體新增至 Contact 實體。 然後，它會從 Contact 實體取得所有相關的結尾，並顯示每個相關端的關聯性名稱、來源角色名稱和目標角色名稱。

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);
    }
}

備註

IRelatedEnd 會定義代表關聯中結尾的物件需求。 這個介面是由類別實作 RelatedEnd 。 RelatedEnd是和 EntityReference<TEntity> 類別的EntityCollection<TEntity>基類。

屬性

IsLoaded	取得值，這個值指出所有相關物件是否都已經載入。
RelationshipName	取得這個相關端所參與之關聯性的名稱。
RelationshipSet	傳回相關端中繼資料的參考。
SourceRoleName	取得位於關聯性來源端的角色名稱。
TargetRoleName	取得位於關聯性目標端的角色名稱。

方法

Add(IEntityWithRelationships)	將物件加入至相關端。
Add(Object)	將物件加入至相關端。
Attach(IEntityWithRelationships)	定義兩個所附加物件之間的關聯性。
Attach(Object)	定義兩個所附加物件之間的關聯性。
CreateSourceQuery()	傳回 IEnumerable，它代表屬於相關端的物件。
GetEnumerator()	傳回 IEnumerator，它會逐一查看相關物件的集合。
Load()	使用預設合併選項，將一個或多個相關物件載入這個相關端中。
Load(MergeOption)	使用指定的合併選項，將一個或多個相關物件載入此相關端中。
Remove(IEntityWithRelationships)	從位於相關端的物件集合中移除物件。
Remove(Object)	從位於相關端的物件集合中移除物件。