ObjectContext.Attach(IEntityWithKey) Método

Definición

Espacio de nombres:

System.Data.Objects

Ensamblado:

System.Data.Entity.dll

Asocia un objeto o un gráfico de objetos al contexto del objeto cuando el objeto tiene una clave de entidad.

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)

Parámetros

entity

IEntityWithKey

Objeto que se va a asociar.

Excepciones

ArgumentNullException

El valor de entity es null.

InvalidOperationException

Clave de entidad no válida.

Ejemplos

En este ejemplo, se asocian dos objetos y, a continuación, se define la relación.

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

Comentarios

Llame a Attach en el ObjectContext para asociar el objeto al contexto del objeto. Hágalo cuando el objeto ya exista en el origen de datos, pero no esté todavía asociado al contexto. Para obtener más información, vea Personalización de objetos.

Attach se usa para adjuntar un objeto o el objeto de nivel superior en un gráfico de objetos.

El objeto que se va a asociar debe implementar IEntityWithKey para exponer una EntityKey. Todas las clases de entidad generadas implementan IEntityWithKey.

Al adjuntar objetos relacionados, también debe llamar a Attach en o EntityReference<TEntity>EntityCollection<TEntity> para definir la relación.

Este método llama al método AttachTo.

Al asociar objetos deben tenerse en cuenta las consideraciones siguientes:

• Si el objeto que se asocia tiene objetos relacionados, esos objetos también se asociarán al contexto del objeto.

• Los objetos se asocian al contexto del objeto en un estado sin modificar.

• El objeto que se pasa al método Attach debe tener un valor de EntityKey válido. Si el objeto no tiene un valor de EntityKey válido, use el método AttachTo para especificar el nombre del conjunto de entidades.

Consulte también

• Attach(TEntity)