ObjectContext.ApplyPropertyChanges(String, Object) Metodo

Definizione

Spazio dei nomi:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Attenzione

Use ApplyCurrentValues instead

Applica le modifiche delle proprietà da un oggetto disconnesso a un oggetto già connesso al contesto dell'oggetto.

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)

Parametri

entitySetName

String

Nome del set di entità a cui appartiene l'oggetto.

changed

Object

Oggetto disconnesso contenente gli aggiornamenti delle proprietà da applicare all'oggetto originale.

Attributi

BrowsableAttribute ObsoleteAttribute

Eccezioni

ArgumentNullException

Se entitySetName è null o una stringa vuota.

-oppure-

Quando changed è null.

InvalidOperationException

Quando l'oggetto EntitySet derivante da entitySetName non corrisponde all'oggetto EntitySet di EntityKey dell'oggetto.

-oppure-

Quando l'entità si trova in un stato diverso da Modified o Unchanged.

-oppure-

L'oggetto originale non è connesso al contesto.

ArgumentException

Quando il tipo dell'oggetto changed non è lo stesso tipo dell'oggetto originale.

Commenti

Il metodo ApplyCurrentValues viene utilizzato per applicare le modifiche delle proprietà da una versione modificata e disconnessa di un oggetto alla versione originale connessa a ObjectContext. Vengono supportati scenari, ad esempio i servizi Web, in cui un oggetto entità viene disconnesso e inviato a un'applicazione remota dove vengono eseguiti gli aggiornamenti delle proprietà. Questo metodo consente di applicare più facilmente le modifiche all'oggetto originale.

Dopo la chiamata al metodo ApplyCurrentValues, lo stato dell'oggetto sarà Modified. È necessario chiamare il metodo SaveChanges per aggiornare l'origine dati.

L'oggetto originale deve essere presente in ObjectStateManager e deve trovarsi nello stato Modified o Unchanged. L'oggetto originale viene modificato solo se nell'oggetto changed sono presenti proprietà modificate.

La proprietà EntityKey dell'oggetto fornito deve essere impostata su un valore di EntityKey valido.

ApplyCurrentValues non influisce sulle proprietà di navigazione o sugli oggetti correlati.

ApplyCurrentValues imposta solo le proprietà che sono presenti nei metadati dell'entità per il tipo. Ad esempio, le proprietà aggiunte in una classe parziale non vengono incluse nell'operazione ApplyCurrentValues.