ObjectContext.ApplyPropertyChanges(String, Object) Methode

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Achtung

Use ApplyCurrentValues instead

Übernimmt Eigenschaftsänderungen eines getrennten Objekts für ein Objekt, das bereits an den Objektkontext angefügt wurde.

public:
 void ApplyPropertyChanges(System::String ^ entitySetName, System::Object ^ changed);

[System.ComponentModel.Browsable(false)]
[System.Obsolete("Use ApplyCurrentValues instead")]
public void ApplyPropertyChanges (string entitySetName, object changed);

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("Use ApplyCurrentValues instead")>]
member this.ApplyPropertyChanges : string * obj -> unit

Public Sub ApplyPropertyChanges (entitySetName As String, changed As Object)

Parameter

entitySetName

String

Der Name der Entitätenmenge, der das Objekt angehört.

changed

Object

Das getrennte Objekt, das über Eigenschaftsaktualisierungen verfügt, die für das ursprüngliche Objekt übernommen werden sollen.

Attribute

BrowsableAttribute ObsoleteAttribute

Ausnahmen

ArgumentNullException

Wenn entitySetName null oder eine leere Zeichenfolge ist.

- oder -

Wenn changednull ist.

InvalidOperationException

Wenn das EntitySet-Element von entitySetName nicht mit dem EntitySet-Element des EntityKey des Objekts übereinstimmt.

- oder -

Wenn die Entität einen anderen Status als Modified oder Unchanged aufweist.

- oder -

Das ursprüngliche Objekt ist nicht an den Kontext angefügt.

ArgumentException

Wenn der Typ des changed-Objekts nicht dem Typ des ursprünglichen Objekts entspricht.

Hinweise

Die ApplyCurrentValues-Methode wird verwendet, um Eigenschaftsänderungen von einer geänderten, getrennten Version eines Objekts für die ursprüngliche Version zu übernehmen, die an den ObjectContext angefügt ist. Dadurch werden Szenarios wie beispielsweise Webdienste unterstützt, bei denen ein Entitätsobjekt getrennt und an eine Remoteanwendung gesendet wird, in der Eigenschaftsaktualisierungen vorgenommen werden. Mithilfe dieser Methode können solche Änderungen einfacher für das ursprüngliche Objekt übernommen werden.

Nach Abschluss von ApplyCurrentValues befindet sich das Objekt im Modified-Status. Sie müssen die SaveChanges -Methode aufrufen, um die Datenquelle zu aktualisieren.

Das ursprüngliche Objekt muss im ObjectStateManager vorhanden sein und den Status Modified oder Unchanged aufweisen. Das ursprüngliche Objekt wird nur geändert, wenn im Objekt geänderte Eigenschaften changed vorhanden sind.

Die EntityKey -Eigenschaft des angegebenen -Objekts muss auf einen gültigen EntityKeyfestgelegt werden.

ApplyCurrentValues wirkt sich nicht auf Navigationseigenschaften oder verwandte Objekte aus.

ApplyCurrentValues legt lediglich Eigenschaften fest, die in den Entitätsmetadaten für den Typ vorhanden sind. Zum Beispiel sind Eigenschaften, die in einer partiellen Klasse hinzugefügt werden, nicht in die ApplyCurrentValues-Operation eingeschlossen.