ObjectContext.ApplyPropertyChanges(String, Object) Metoda

Definicja

Przestrzeń nazw:

System.Data.Objects

Zestaw:

System.Data.Entity.dll

Przestroga

Use ApplyCurrentValues instead

Stosuje zmiany właściwości z odłączonego obiektu do obiektu już dołączonego do kontekstu obiektu.

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)

Parametry

entitySetName

String

Nazwa jednostki, do której należy obiekt.

changed

Object

Odłączony obiekt, który ma aktualizacje właściwości do zastosowania do oryginalnego obiektu.

Atrybuty

BrowsableAttribute ObsoleteAttribute

Wyjątki

ArgumentNullException

Gdy entitySetName jest lub pusty null ciąg.

-lub-

Gdy changed jest to null.

InvalidOperationException

Gdy element EntitySet od entitySetName nie jest zgodny EntitySet z wartością obiektu EntityKey.

-lub-

Gdy jednostka jest w stanie innym niż Modified lub Unchanged.

-lub-

Oryginalny obiekt nie jest dołączony do kontekstu.

ArgumentException

Gdy typ changed obiektu nie jest taki sam jak oryginalny obiekt.

Uwagi

Metoda ApplyCurrentValues służy do stosowania zmian właściwości z zmodyfikowanej, odłączonej wersji obiektu do oryginalnej wersji dołączonej ObjectContextdo elementu . Obsługuje to scenariusze, takie jak usługi sieci Web, w których obiekt jednostki jest odłączony i wysyłany do aplikacji zdalnej, w której są wprowadzane aktualizacje właściwości. Ta metoda umożliwia łatwiejsze stosowanie tych zmian z powrotem do oryginalnego obiektu.

Po ApplyCurrentValues, obiekt jest w Modified stanie. Aby zaktualizować źródło danych, należy wywołać metodę SaveChanges .

Oryginalny obiekt musi istnieć w obiekcie ObjectStateManager i musi być w Modified stanie lub Unchanged . Oryginalny obiekt jest modyfikowany tylko wtedy, gdy w changed obiekcie są modyfikowane właściwości.

Właściwość EntityKey podanego obiektu musi być ustawiona na prawidłową EntityKeywartość .

ApplyCurrentValues nie ma wpływu na właściwości nawigacji ani powiązane obiekty.

ApplyCurrentValues ustawia tylko właściwości, które istnieją w metadanych jednostki dla typu. Na przykład właściwości dodane w klasie częściowej nie są uwzględniane w ApplyCurrentValues operacji.