ObjectContext.Attach(IEntityWithKey) Metod

Definition

Namnområde:
System.Data.Objects
Sammansättning:
System.Data.Entity.dll

Bifogar ett objekt eller objektdiagram till objektkontexten när objektet har en entitetsnyckel.

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)

Parametrar

entity
IEntityWithKey

Objektet som ska bifogas.

Undantag

ArgumentNullException

entity är null.

InvalidOperationException

Ogiltig entitetsnyckel.

Exempel

I det här exemplet kopplas två objekt och sedan definieras relationen.

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

Kommentarer

Anropa Attach för ObjectContext att koppla objektet till objektkontexten. Gör detta när objektet redan finns i datakällan men för närvarande inte är kopplat till kontexten. Mer information finns i Anpassa objekt.

Attach används för att bifoga ett objekt eller det översta objektet i ett objektdiagram.

Objektet som bifogas måste implementeras IEntityWithKey för att exponera en EntityKey. Alla genererade entitetsklasser implementerar IEntityWithKey.

När du bifogar relaterade objekt måste du också anropa Attach på EntityReference<TEntity> eller EntityCollection<TEntity> för att definiera relationen.

Den här metoden anropar AttachTo metoden.

Följande överväganden gäller vid anslutning av objekt:

  • Om objektet som bifogas har relaterade objekt, kommer dessa objekt också att kopplas till objektkontexten.

  • Objekt läggs till i objektkontexten i ett oförändrat tillstånd.

  • Objektet som skickas till Attach metoden måste ha ett giltigt EntityKey värde. Om objektet inte har ett giltigt EntityKey värde använder du AttachTo metoden för att ange namnet på entitetsuppsättningen.

Gäller för

Se även