ObjectContext.Attach(IEntityWithKey) Méthode

Définition

Espace de noms:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Attache un graphique d’objet ou d’objet au contexte de l’objet lorsque l’objet a une clé d’entité.

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)

Paramètres

entity
IEntityWithKey

Objet à attacher.

Exceptions

ArgumentNullException

entity a la valeur null.

InvalidOperationException

Clé d’entité non valide.

Exemples

Dans cet exemple, deux objets sont attachés, puis la relation est définie.

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

Remarques

Appelez Attach l’objet ObjectContext pour attacher l’objet au contexte de l’objet. Procédez ainsi lorsque l’objet existe déjà dans la source de données, mais qu’il n’est actuellement pas attaché au contexte.

Attach est utilisé pour attacher un objet ou l’objet de niveau supérieur dans un graphique d’objet.

L’objet attaché doit être implémenté IEntityWithKey pour exposer un EntityKey. Toutes les classes d’entité générées implémentent IEntityWithKey.

Lorsque vous attachez des objets connexes, vous devez également appeler Attach le EntityReference<TEntity> ou le EntityCollection<TEntity> pour définir la relation.

Cette méthode appelle la AttachTo méthode.

Les considérations suivantes s’appliquent lors de l’attachement d’objets :

  • Si l’objet attaché a des objets connexes, ces objets sont également attachés au contexte de l’objet.

  • Les objets sont ajoutés au contexte d’objet dans un état inchangé.

  • L’objet passé à la Attach méthode doit avoir une valeur valide EntityKey . Si l’objet n’a pas de valeur valide EntityKey , utilisez la AttachTo méthode pour spécifier le nom du jeu d’entités.

S’applique à

Voir aussi