ObjectContext.Attach(IEntityWithKey) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt ein Objekt oder ein 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 -> unitPublic Sub Attach (entity As IEntityWithKey)Parameter
- entity
- IEntityWithKey
Das anzufügende Objekt.
Ausnahmen
entity ist null.
Ungültiger Entitätsschlüssel.
Beispiele
In diesem Beispiel werden zwei Objekte angefügt und dann 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 das ObjectContext Objekt auf, um das Objekt an den Objektkontext anzufügen. Gehen Sie dazu vor, wenn das Objekt bereits in der Datenquelle vorhanden ist, aber derzeit nicht an den Kontext angefügt ist.
Attach wird verwendet, um ein Objekt oder das Objekt der obersten Ebene in einem Objektdiagramm anzufügen.
Das angefügte Objekt muss implementiert IEntityWithKey werden, um ein EntityKeyObjekt verfügbar zu machen. Alle generierten Entitätsklassen implementieren IEntityWithKey.
Wenn Sie verwandte Objekte anfügen, müssen Sie auch die EntityReference<TEntity> Beziehung oder die EntityCollection<TEntity> zum Definieren der Beziehung aufrufenAttach.
Diese Methode ruft die AttachTo Methode auf.
Die folgenden Überlegungen gelten beim Anfügen von Objekten:
Wenn das angefügte Objekt verwandte Objekte aufweist, werden diese Objekte auch an den Objektkontext angefügt.
Objekte werden dem Objektkontext in einem unveränderten Zustand 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, verwenden Sie die AttachTo Methode, um den Namen des Entitätssatzes anzugeben.
