ObjectContext.AttachTo(String, Object) Metoda

Definicja

Przestrzeń nazw:

System.Data.Objects

Zestaw:

System.Data.Entity.dll

Dołącza wykres obiektu lub obiektu do kontekstu obiektu w określonym zestawie jednostek.

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity);

public void AttachTo (string entitySetName, object entity);

member this.AttachTo : string * obj -> unit

Public Sub AttachTo (entitySetName As String, entity As Object)

Parametry

entitySetName

String

Reprezentuje nazwę zestawu jednostek, która może być opcjonalnie kwalifikowana przez nazwę kontenera jednostki.

entity

Object

Element Object do dołączenia.

Wyjątki

ArgumentNullException

Wartość entity to null.

InvalidOperationException

Nieprawidłowy zestaw jednostek.

-lub-

Obiekt ma klucz tymczasowy.

-lub-

Obiekt ma EntityKey element i EntitySet element nie jest zgodny z zestawem jednostek przekazanym jako argument metody .

-lub-

Obiekt nie ma EntityKey elementu i nie podano żadnego zestawu jednostek.

-lub-

Każdy obiekt z grafu obiektów ma tymczasowy EntityKeyobiekt .

-lub-

Dowolny obiekt z grafu obiektów ma nieprawidłowy EntityKey element (na przykład wartości w kluczu nie pasują do wartości w obiekcie).

-lub-

Nie można odnaleźć zestawu jednostek z podanej entitySetName nazwy i nazwy kontenera jednostki.

-lub-

Każdy obiekt z grafu obiektów już istnieje w innym menedżerze stanu.

Uwagi

Wywołaj AttachTo metodę , ObjectContext aby dołączyć obiekt do określonego zestawu jednostek w kontekście obiektu lub jeśli obiekt ma null wartość (Nothingw Visual Basic). EntityKey Aby uzyskać więcej informacji, zobacz Dołączanie i odłączanie obiektów.

Dołączany obiekt może być pojedynczym obiektem lub być częścią grafu.

Reguły dla entitySetName formatu są następujące:

• DefaultContainerName Jeśli właściwość ma nullwartość , entitySetName element musi być w pełni kwalifikowany jako w <polu Nazwa> kontenera jednostki.<Nazwa> zestawu jednostek.

• Jeśli parametr DefaultContainerName nie nullma wartości , entitySetName może to być nazwa kontenera> jednostki<.<Nazwa> zestawu jednostek lub <nazwa> zestawu jednostek.

Dołączany obiekt nie jest wymagany do skojarzenia EntityKey z nim obiektu. Jeśli obiekt nie ma klucza jednostki, entitySetName nie może być pustym ciągiem.

Jeśli dołączony obiekt ma EntityKey wartość i entitySetName ma wartość , EntitySet klucz jednostki musi być zgodny EntitySet z znalezioną wartością na entitySetName podstawie nazwy kontenera jednostki i .

Zobacz też

• Attach(TEntity)
• Praca z obiektami (Entity Framework)