Freigeben über


ObjectContext.AttachTo(String, Object) Methode

Definition

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.

entity
Object

Das anzufügende Object.

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 istnull, muss vollqualifiziert entitySetName werden wie in <Entitätscontainername>.<Name> der Entitätsmenge.

  • Wenn nicht DefaultContainerNamenullist, kann es entitySetName 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.

Gilt für:

Weitere Informationen