ObjectContext.Attach(IEntityWithKey) Methode

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Fügt ein Objekt oder Objektdiagramm an den Objektkontext an, wenn das Objekt über einen Entitätsschlüssel verfügt.

public:
 void Attach(System::Data::Objects::DataClasses::IEntityWithKey ^ entity);

public void Attach (System.Data.Objects.DataClasses.IEntityWithKey entity);

member this.Attach : System.Data.Objects.DataClasses.IEntityWithKey -> unit

Public Sub Attach (entity As IEntityWithKey)

Parameter

entity

IEntityWithKey

Das anzufügende Objekt.

Ausnahmen

ArgumentNullException

entity ist null.

InvalidOperationException

Ungültiger Entitätsschlüssel.

Beispiele

In diesem Beispiel werden zwei Objekte angefügt, und anschließend wird die Beziehung definiert.

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

Hinweise

Rufen Sie Attach für den ObjectContext auf, um das Objekt an den Objektkontext anzufügen. Gehen Sie dazu vor, wenn das Objekt bereits in der Datenquelle vorhanden, aber derzeit nicht an den Kontext angefügt ist. Weitere Informationen finden Sie unter Anpassen von Objekten.

Attach wird verwendet, um ein Objekt oder das Objekt der obersten Ebene in einem Objektgraphen anzufügen.

Das anzufügende Objekt muss IEntityWithKey implementieren, um einen EntityKey bereitzustellen. Von allen generierten Entitätsklassen wird IEntityWithKey implementiert.

Wenn Sie verknüpfte Objekte anfügen, müssen Sie auch für oder EntityReference<TEntity> aufrufenAttach, EntityCollection<TEntity> um die Beziehung zu definieren.

Diese Methode ruft die AttachTo-Methode auf.

Folgendes gilt beim Anfügen von Objekten:

• Wenn das anzufügende Objekt über verbundene Objekte verfügt, werden auch diese Objekte an den Objektkontext angefügt.

• Objekte werden dem Objektkontext im Status "Unchanged" hinzugefügt.

• Das Objekt, das an die Attach-Methode übergeben wird, muss über einen gültigen EntityKey-Wert verfügen. Wenn das Objekt keinen gültigen EntityKey-Wert aufweist, geben Sie den Namen des Entitätssatzes mit der AttachTo-Methode an.

Weitere Informationen

• Attach(TEntity)