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 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
entity
ist null
.
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.