ObjectContext.ApplyPropertyChanges(String, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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);
public void ApplyPropertyChanges (string entitySetName, object changed);
[System.ComponentModel.Browsable(false)]
[System.Obsolete("Use ApplyCurrentValues instead")]
public void ApplyPropertyChanges (string entitySetName, object changed);
member this.ApplyPropertyChanges : string * obj -> unit
[<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
Excepciones
Cuando entitySetName
es null
o una cadena vacía.
o bien
Cuando changed
es null
.
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.
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.