ObjectContext.Attach(IEntityWithKey) 方法

定义

命名空间:

System.Data.Objects

程序集:

System.Data.Entity.dll

在对象具有实体键时将对象或对象图附加到对象上下文。

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)

参数

entity

IEntityWithKey

要附加的对象。

例外

ArgumentNullException

entity 为 null。

InvalidOperationException

无效的实体键。

示例

在此示例中，附加了两个对象，然后定义了关系。

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

注解

调用 Attach 的 ObjectContext 可将对象附加到对象上下文。 当对象已存在于数据源中但当前尚未附加到上下文时采用此方法。 有关详细信息，请参阅 自定义对象。

Attach 用于在对象图中附加对象或顶级对象。

要附加的对象必须实现 IEntityWithKey 以公开 EntityKey。 所有生成的实体类都实现 IEntityWithKey。

附加相关对象时，还必须对 EntityReference<TEntity> 或 EntityCollection<TEntity> 调用 Attach 来定义关系。

此方法调用 AttachTo 方法。

在附加对象时需要考虑下列注意事项：

• 如果要附加的对象具有相关对象，则这些对象也会附加到对象上下文。

• 对象以未更改状态添加到对象上下文。

• 传递到 Attach 方法的对象必须具有有效的 EntityKey 值。 如果对象没有有效的 EntityKey 值，请使用 AttachTo 方法指定实体集的名称。

另请参阅

• Attach(TEntity)