ObjectContext.ApplyPropertyChanges(String, Object) Méthode

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Attention

Use ApplyCurrentValues instead

Applique les modifications de propriété d'un objet détaché à un objet déjà attaché au contexte de l'objet.

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)

Paramètres

entitySetName

String

Nom du jeu d'entités auquel appartient l'objet.

changed

Object

Objet détaché ayant les mises à jour de propriétés à appliquer à l'objet d'origine.

Attributs

BrowsableAttribute ObsoleteAttribute

Exceptions

ArgumentNullException

Lorsque entitySetName est null ou une chaîne vide.

- ou -

Lorsque changed est null.

InvalidOperationException

Quand le EntitySet de entitySetName ne correspond pas au EntitySet du EntityKey de l’objet.

- ou -

Lorsque l'entité est dans un état autre que Modified ou Unchanged.

- ou -

L'objet d'origine n'est pas attaché au contexte.

ArgumentException

Lorsque le type de l'objet changed est différent de celui de l'objet d'origine.

Remarques

La méthode ApplyCurrentValues est utilisée pour appliquer des modifications de propriétés d'une version modifiée, détachée d'un objet à la version d'origine attachée à l'objet ObjectContext. Cela prend en charge les scénarios, tels que les services Web, dans lesquels un objet entité est détaché et envoyé à une application distante où des mises à jour de propriétés sont effectuées. Cette méthode vous permet d'appliquer plus facilement ces modifications à l'objet d'origine.

Après ApplyCurrentValues, l'objet est à l'état Modified. Vous devez appeler la méthode SaveChanges pour mettre à jour la source de données.

L'objet d'origine doit exister dans l'objet ObjectStateManager et doit être à l'état Modified ou Unchanged. L’objet d’origine est modifié uniquement s’il existe des propriétés modifiées dans l’objet changed .

La propriété EntityKey de l'objet fourni doit être déifnie sur un EntityKey valide.

ApplyCurrentValues n’affecte pas les propriétés de navigation ou les objets associés.

ApplyCurrentValues définit seulement les propriétés qui existent dans les métadonnées d'entité pour le type. Par exemple, les propriétés ajoutées dans une classe partielle ne sont pas incluses dans l'opération ApplyCurrentValues.