ObjectContext.Attach(IEntityWithKey) Metoda

Definicja

Przestrzeń nazw:

System.Data.Objects

Zestaw:

System.Data.Entity.dll

Dołącza wykres obiektu lub obiektu do kontekstu obiektu, gdy obiekt ma klucz jednostki.

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)

Parametry

entity

IEntityWithKey

Obiekt do dołączenia.

Wyjątki

ArgumentNullException

Wartość entity to null.

InvalidOperationException

Nieprawidłowy klucz jednostki.

Przykłady

W tym przykładzie dołączono dwa obiekty, a następnie zdefiniowano relację.

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

Uwagi

Wywołaj Attach metodę , ObjectContext aby dołączyć obiekt do kontekstu obiektu. Zrób to, gdy obiekt już istnieje w źródle danych, ale nie jest obecnie dołączony do kontekstu. Aby uzyskać więcej informacji, zobacz Dostosowywanie obiektów.

Attach służy do dołączania obiektu lub obiektu najwyższego poziomu w grafie obiektu.

Dołączany obiekt musi zostać zaimplementowany IEntityWithKey w celu uwidocznienia obiektu EntityKey. Wszystkie wygenerowane klasy jednostek implementują element IEntityWithKey.

Podczas dołączania powiązanych obiektów należy również wywołać Attach metodę EntityReference<TEntity> w obiekcie lub EntityCollection<TEntity> , aby zdefiniować relację.

Ta metoda wywołuje metodę AttachTo .

Podczas dołączania obiektów mają zastosowanie następujące kwestie:

• Jeśli dołączony obiekt ma powiązane obiekty, te obiekty również zostaną dołączone do kontekstu obiektu.

• Obiekty są dodawane do kontekstu obiektu w niezmienionym stanie.

• Obiekt przekazany do Attach metody musi mieć prawidłową EntityKey wartość. Jeśli obiekt nie ma prawidłowej EntityKey wartości, użyj AttachTo metody , aby określić nazwę zestawu jednostek.

Zobacz też

• Attach(TEntity)