ObjectContext.Attach(IEntityWithKey) Méthode

Définition

Attache un objet ou graphique 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

entity a la valeur null.

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 la méthode Attach sur l'objet ObjectContext pour attacher l'objet au contexte de l'objet. Procédez de cette manière lorsque l'objet existe déjà dans la source de données, mais qu'il n'est pas encore attaché au contexte. Pour plus d’informations, consultez Personnalisation des objets.

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

L'objet qui est attaché doit implémenter IEntityWithKey pour exposer un objet EntityKey. Toutes les classes d'entités générées implémentent IEntityWithKey.

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

Cette méthode appelle la méthode AttachTo.

Vous devez tenir compte des points suivants lors de l'attachement d'objets :

  • Si l'objet qui est attaché a des objets connexes, ces objets seront également attachés au contexte de l'objet.

  • Les objets sont ajoutés au contexte de l'objet dans un état inchangé.

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

S’applique à

Voir aussi