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

Element entity to null.

InvalidOperationException

Nieprawidłowy zestaw jednostek.

-lub-

Obiekt ma klucz tymczasowy.

-lub-

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

-lub-

Obiekt nie ma EntityKey zestawu jednostek i nie jest podany.

-lub-

Dowolny obiekt z grafu obiektu ma tymczasowy EntityKeyobiekt .

-lub-

Dowolny obiekt z grafu obiektu ma nieprawidłowy element EntityKey (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-

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

Uwagi

Wywołaj AttachTo metodę , ObjectContext aby dołączyć obiekt do określonej jednostki ustawionej w kontekście obiektu lub jeśli obiekt ma null wartość (Nothingw języku 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 częścią grafu.

Reguły formatu entitySetName 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. 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 znalezionym elementem na entitySetName podstawie nazwy kontenera jednostek i .

Zobacz też

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