ObjectContext.ApplyPropertyChanges(String, Object) Método

Definición

Espacio de nombres:

System.Data.Objects

Ensamblado:

System.Data.Entity.dll

Precaución

Use ApplyCurrentValues instead

Aplica los cambios de propiedades de un objeto desasociado a un objeto ya asociado al contexto del objeto.

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)

Parámetros

entitySetName

String

Nombre del conjunto de entidades al que pertenece el objeto.

changed

Object

Objeto desasociado que tiene actualizaciones de propiedades que deben aplicarse al objeto original.

Atributos

BrowsableAttribute ObsoleteAttribute

Excepciones

ArgumentNullException

Cuando entitySetName es null o una cadena vacía.

o bien

Cuando changed es null.

InvalidOperationException

Cuando EntitySet de entitySetName no coincide con EntitySet de EntityKey del objeto.

o bien

Cuando la entidad se encuentra en un estado distinto de Modified o Unchanged.

o bien

El objeto original no está asociado al contexto.

ArgumentException

Cuando el tipo del objeto changed no es el mismo tipo que el objeto original.

Comentarios

El método ApplyCurrentValues se usa para aplicar los cambios de propiedades de una versión desasociada de un objeto que se ha modificado a la versión original asociada a ObjectContext. Esto es compatible con los escenarios, como los servicios Web, donde un objeto entidad se desasocia y se envía a una aplicación remota en que se actualizan propiedades. Este método permite aplicar más fácilmente estos cambios en el objeto original.

Después de ejecutar ApplyCurrentValues, el objeto se encuentra en el estado Modified. Debe llamar al método SaveChanges para actualizar el origen de datos.

El objeto original debe existir en el ObjectStateManager y tener el estado Modified o Unchanged. El objeto original solo se modifica si hay propiedades modificadas en el changed objeto .

La propiedad EntityKey del objeto proporcionado se debe establecer en un valor de EntityKey válido.

ApplyCurrentValues no afecta a las propiedades de navegación ni a los objetos relacionados.

ApplyCurrentValues solo establece propiedades que existen en los metadatos de entidad para el tipo. Por ejemplo, las propiedades que se agregan en una clase parcial no se incluyen en la operación ApplyCurrentValues.