ObjectContext.AttachTo(String, Object) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.
Wyjątki
Wartość entity
to null
.
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ść (Nothing
w 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
null
wartość ,entitySetName
element musi być w pełni kwalifikowany jako w <polu Nazwa> kontenera jednostki.<Nazwa> zestawu jednostek.Jeśli parametr DefaultContainerName nie
null
ma 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 .