ObjectContext.AttachTo(String, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt ein Objekt oder Objektdiagramm an den Objektkontext in einer bestimmten Entitätenmenge an.
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)
Parameter
- entitySetName
- String
Stellt den Namen der Entitätenmenge dar, der optional durch den Entitätencontainernamen qualifiziert werden kann.
Ausnahmen
entity
ist null
.
Ungültige Entitätenmenge.
- oder -
Das Objekt verfügt über einen temporären Schlüssel.
- oder -
Das Objekt verfügt über einen EntityKey, und die EntitySet stimmt nicht mit der Entitätenmenge überein, die der Methode als Argument übergeben wurde.
- oder -
Das Objekt hat keinen EntityKey, und es ist keine Entitätenmenge angegeben.
- oder -
Ein Objekt aus dem Objektdiagramm verfügt über einen temporären EntityKey.
- oder -
Ein Objekt aus dem Objektdiagramm verfügt über einen ungültigen EntityKey (Beispiel: Werte im Schlüssel stimmen nicht mit Werten im Objekt überein).
- oder -
Der Entitätssatz wurde nicht anhand eines angegebenen entitySetName
und Entitätscontainernamens gefunden.
- oder -
Ein Objekt aus dem Objektdiagramm ist bereits in einem anderen Status-Manager vorhanden.
Hinweise
Rufen Sie AttachTo auf, ObjectContext um das Objekt an eine bestimmte Entitätsmenge im Objektkontext anzufügen, oder wenn das Objekt über einen null
(Nothing
in Visual Basic) Wert verfügt EntityKey . Weitere Informationen finden Sie unter Anfügen und Trennen von Objekten.
Das anzufügende Objekt kann eigenständig oder Teil des Diagramms sein.
Die Regeln für das entitySetName
Format sind wie folgt:
Wenn die DefaultContainerName -Eigenschaft ist
null
, muss vollqualifiziertentitySetName
werden wie in <Entitätscontainername>.<Name> der Entitätsmenge.Wenn nicht DefaultContainerName
null
ist, kann esentitySetName
sich um einen <Entitätscontainernamen handeln>.<Name> des Entitätssatzes oder <Name des Entitätssatzes>.
Das anzufügende Objekt muss keinen damit verbundenen EntityKey haben. Wenn das Objekt keinen Entitätsschlüssel aufweist, entitySetName
kann es sich nicht um eine leere Zeichenfolge handeln.
Wenn das angefügte Objekt über einen EntityKey und entitySetName
einen Wert verfügt, muss der EntitySet des Entitätsschlüssels mit dem übereinstimmen, der EntitySet basierend auf dem Entitätscontainernamen und gefunden entitySetName
wurde.