ObjectContext.Attach(IEntityWithKey) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee koppelt u een object- of objectgrafiek aan de objectcontext wanneer het object een entiteitssleutel heeft.
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)Parameters
- entity
- IEntityWithKey
Het object dat moet worden gekoppeld.
Uitzonderingen
De entity is null.
Ongeldige entiteitssleutel.
Voorbeelden
In dit voorbeeld worden twee objecten gekoppeld en wordt de relatie gedefinieerd.
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);
}
}
Opmerkingen
Roep de ObjectContext aanroep Attach uit om het object aan de objectcontext te koppelen. Doe dit wanneer het object al bestaat in de gegevensbron, maar momenteel niet is gekoppeld aan de context. Zie Objecten aanpassen voor meer informatie.
Attach wordt gebruikt om een object of het object op het hoogste niveau in een objectgrafiek te koppelen.
Het object dat wordt gekoppeld, moet worden geïmplementeerd om een EntityKeybeschikbaar te makenIEntityWithKey. Alle gegenereerde entiteitsklassen implementeren IEntityWithKey.
Wanneer u gerelateerde objecten koppelt, moet u ook de EntityReference<TEntity> relatie aanroepen Attach of de EntityCollection<TEntity> relatie definiëren.
Met deze methode wordt de methode aangeroepen AttachTo .
De volgende overwegingen zijn van toepassing bij het koppelen van objecten:
Als het object dat wordt gekoppeld gerelateerde objecten bevat, worden deze objecten ook gekoppeld aan de objectcontext.
Objecten worden toegevoegd aan de objectcontext in een ongewijzigde status.
Het object dat aan de Attach methode wordt doorgegeven, moet een geldige EntityKey waarde hebben. Als het object geen geldige EntityKey waarde heeft, gebruikt u de AttachTo methode om de naam van de entiteitsset op te geven.