ObjectContext.AttachTo(String, Object) Methode

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

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

ArgumentNullException

entity ist null.

InvalidOperationException

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.

Weitere Informationen

• Attach(TEntity)
• Arbeiten mit Objekten (Entity Framework)