PropertyDescriptor.SetValue(Object, 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í.
Cuando se reemplaza en una clase derivada, establece el valor del componente en otro diferente.
public:
abstract void SetValue(System::Object ^ component, System::Object ^ value);
public abstract void SetValue (object component, object value);
public abstract void SetValue (object? component, object? value);
abstract member SetValue : obj * obj -> unit
Public MustOverride Sub SetValue (component As Object, value As Object)
Parámetros
- component
- Object
Componente con el valor de propiedad que se va a establecer.
- value
- Object
Nuevo valor.
Comentarios
Normalmente, este método se implementa a través de la reflexión.
Este método crea automáticamente un objeto DesignerTransaction en el orden siguiente:
El método llama al IDesignerHost.CreateTransaction método para crear un nuevo DesignerTransaction objeto para representar los cambios.
El método llama al IComponentChangeService.OnComponentChanging método para indicar que se ha iniciado la transacción y que los cambios están a punto de producirse.
El método restablece la propiedad al valor determinado por el orden de comprobación de este método.
El método llama al IComponentChangeService.OnComponentChanged método para indicar que se han producido los cambios.
El método llama DesignerTransaction.Commit a para indicar que la transacción está completa.
El propósito de la transacción es admitir Undo
y Redo
funcionalidad.
Notas a los implementadores
Al invalidar este método, debe establecer el valor de la propiedad invocando el método "SetMyProperty" adecuado que necesita implementar. Si el valor especificado no es válido, el componente debe producir una excepción, que se pasa. Debe diseñar la propiedad para que un método "GetMyProperty" (que haya implementado) después de un método "SetMyProperty" devuelva el valor pasado cuando el método "SetMyProperty" no produzca una excepción.