EntityCollection<TEntity>.Attach Yöntem

Tanım

Ad Alanı:

System.Data.Objects.DataClasses

Bütünleştirilmiş Kod:

System.Data.Entity.dll

Nesne bağlamında ekli iki nesne arasında bir ilişki tanımlar.

Aşırı Yüklemeler

Attach(IEnumerable<TEntity>)	Bir nesne ile nesne bağlamındaki ilgili nesneler koleksiyonu arasındaki ilişkileri tanımlar.
Attach(TEntity)	Nesne bağlamında ekli iki nesne arasında bir ilişki tanımlar.

Attach(IEnumerable<TEntity>)

Bir nesne ile nesne bağlamındaki ilgili nesneler koleksiyonu arasındaki ilişkileri tanımlar.

public:
 void Attach(System::Collections::Generic::IEnumerable<TEntity> ^ entities);

public void Attach (System.Collections.Generic.IEnumerable<TEntity> entities);

override this.Attach : seq<'Entity (requires 'Entity : null)> -> unit

Public Sub Attach (entities As IEnumerable(Of TEntity))

Parametreler

entities

IEnumerable<TEntity>

Kaynak nesneyle ilgili nesne bağlamındaki nesnelerin koleksiyonu.

Özel durumlar

ArgumentNullException

entities koleksiyonu şeklindedir null.

InvalidOperationException

Kaynak nesne veya koleksiyondaki entitiesnull bir nesne ya da durumunda UnchangedModified değil.

-veya-

İlişki EDM meta verilerine göre tanımlanamaz. Kavramsal şemadaki ilişkilendirme iki tür arasındaki ilişkiyi desteklemediğinde bu durum oluşabilir.

Açıklamalar

yöntemi Attach , hem kaynak nesne hem de ilgili nesnelerin koleksiyonu nesne bağlamında zaten mevcut olduğunda bir nesne ile ilgili nesneler koleksiyonu arasındaki ilişkileri tanımlamak için kullanılır. İlişkilerin zaten tanımlandığı bir nesne veya nesne grafı eklemek için üzerinde yöntemini çağırın AttachObjectContext. Kaynak nesneyle ilgili yeni bir nesne oluşturmak için üzerinde yöntemini çağırın AddEntityCollection<TEntity>. Daha fazla bilgi için bkz. Nesneleri Ekleme ve Ayırma.

Koleksiyon zaten doldurulmuşsa veya kısmen doldurulmuşsa, Attach yöntemi mevcut varlıkları verilen varlıklarla birleştirir. Verilen varlıkların, ilgili varlıkların tam kümesi olduğu varsayılmaz.

geçirilen tüm varlıklar veya Modified durumunda Unchanged olmalıdır. Durumdaki nesnelere Deleted yalnızca durum yöneticisi zaten ilişki örneğini izlediğinde izin verilir.

Attach(TEntity)

Nesne bağlamında ekli iki nesne arasında bir ilişki tanımlar.

public:
 void Attach(TEntity entity);

public void Attach (TEntity entity);

override this.Attach : 'Entity -> unit

Public Sub Attach (entity As TEntity)

Parametreler

entity

TEntity

Eklenen nesne.

Özel durumlar

ArgumentNullException

entity olduğundanull.

InvalidOperationException

kaynak nesneyle entity ilişkilendirilemediğinde. Kavramsal şemadaki ilişkilendirme iki tür arasındaki ilişkiyi desteklemediğinde bu durum oluşabilir.

-veya-

Nesnelerden null biri veya durumunda UnchangedModified değilse.

Örnekler

Bu örnekte Adventure Works Satış Modeli temel alınmaktadır. Bu örnekteki kodu çalıştırmak için AdventureWorks Satış Modeli'ni projenize zaten eklemiş ve projenizi Entity Framework kullanacak şekilde yapılandırmış olmanız gerekir. Bunu yapmak için , Nasıl yapılır: Entity Framework Projesini El ile Yapılandırma ve Nasıl Yapılır: Modeli ve Eşleme Dosyalarını El ile Tanımlama bölümündeki yordamları tamamlayın.

Bu örnek, bir nesne bağlamı için bir ayrılmış SalesOrderDetail nesneler ve bir ayrılmış SalesOrderHeader nesne koleksiyonu ekler ve sonra nesne ile her SalesOrderDetail nesne arasındaki SalesOrderHeader ilişkileri tanımlar.

private static void AttachRelatedObjects(
    ObjectContext currentContext,
    SalesOrderHeader detachedOrder,
    List<SalesOrderDetail> detachedItems)
{
    // Attach the root detachedOrder object to the supplied context.
    currentContext.Attach(detachedOrder);

    // Attach each detachedItem to the context, and define each relationship
    // by attaching the attached SalesOrderDetail object to the EntityCollection on
    // the SalesOrderDetail navigation property of the now attached detachedOrder.
    foreach (SalesOrderDetail item in detachedItems)
    {
        currentContext.Attach(item);
        detachedOrder.SalesOrderDetails.Attach(item);
    }
}

Açıklamalar

yöntemi Attach , her iki nesne nesne bağlamında zaten mevcut olduğunda iki nesne arasındaki ilişkileri tanımlamak için kullanılır. İlişkilerin zaten tanımlandığı bir nesne veya nesne grafı eklemek için üzerinde yöntemini çağırın AttachObjectContext. Kaynak nesneyle ilgili yeni bir nesne oluşturmak için üzerinde yöntemini çağırın AddEntityCollection<TEntity>. Daha fazla bilgi için bkz. Nesneleri Ekleme ve Ayırma.

EntityCollection<TEntity> zaten yüklü nesnelere sahipse, Attach yöntemi nesnesini içindeki EntityCollection<TEntity>mevcut nesnelerle birleştirir.

İliştirilen nesnenin ilgili varlık nesnelerinin tam kümesi olduğu varsayılmaz.

Bununla EntityCollection<TEntity> ilişkilendirilmiş nesne ve bu nesneye eklenen tüm nesneler veya UnchangedModified durumunda olmalıdır.

Durumdaki Deleted nesneler yalnızca ilişki örneğini zaten izlediğinde ObjectStateManager eklenebilir.