EntityCollection<TEntity>.Add(TEntity) 方法

定義

命名空間:

System.Data.Objects.DataClasses

組件:

System.Data.Entity.dll

將物件加入至集合。

public:
 virtual void Add(TEntity entity);

public void Add (TEntity entity);

override this.Add : 'Entity -> unit

Public Sub Add (entity As TEntity)

參數

entity

TEntity

要加入集合的物件。 entity 必須實作 IEntityWithRelationships。

實作

Add(T)

例外狀況

ArgumentNullException

entity 為 null。

範例

這個範例是根據 Adventure Works Sales Model。 若要執行此範例中的程式碼，您必須已經將 AdventureWorks Sales Model 加入到專案中，並設定您的專案使用 Entity Framework。 若要這樣做，請完成 如何：手動設定 Entity Framework 專案 和 如何：手動定義模型和對應檔案中的程式。

這個範例會建立兩個新的 SalesOrderHeader 實體、將它們加入至 Contact 實體，然後在移除物件之後，使用 Add 方法，將此物件重新加入至集合。

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)
    {
        // Get Entity Collection from related end
        EntityCollection<SalesOrderHeader> entityCollection =
            (EntityCollection<SalesOrderHeader>)relEnd;

        Console.WriteLine("EntityCollection count: {0}",
            entityCollection.Count);
        // Remove the first entity object.
        entityCollection.Remove(newSalesOrder1);

        bool contains = entityCollection.Contains(newSalesOrder1);

        // Write the number of items after one entity has been removed
        Console.WriteLine("EntityCollection count after one entity has been removed: {0}",
            entityCollection.Count);

        if (contains == false)
            Console.WriteLine("The removed entity is not in in the collection any more.");

        //Use IRelatedEnd to add the entity back.
        relEnd.Add(newSalesOrder1);
        Console.WriteLine("EntityCollection count after an entity has been added again: {0}",
            entityCollection.Count);
    }
}

備註

Add 方法會將物件加入至 EntityCollection<TEntity> 並且建立這兩個物件之間的關聯性。 當來源物件附加至 ObjectContext 執行個體時，Add 方法也會將此物件加入至 ObjectContext。 呼叫 SaveChanges 時，這項作業就會在資料來源中轉譯成插入作業。 如需詳細資訊，請參閱 建立、新增、修改和刪除物件。

Add 方法可以在同一個物件執行個體上呼叫多次。