PropertyDescriptor.SetValue(Object, Object) PropertyDescriptor.SetValue(Object, Object) PropertyDescriptor.SetValue(Object, Object) PropertyDescriptor.SetValue(Object, Object) Method

Définition

En cas de substitution dans une classe dérivée, affecte une autre valeur au composant.When overridden in a derived class, sets the value of the component to a different value.

public:
 abstract void SetValue(System::Object ^ component, System::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)

Paramètres

component
Object Object Object Object

Composant dont la valeur de la propriété doit être définie.The component with the property value that is to be set.

value
Object Object Object Object

Nouvelle valeur.The new value.

Remarques

En général, cette méthode est implémentée via la réflexion.Typically, this method is implemented through reflection.

Cette méthode crée automatiquement DesignerTransaction un dans l’ordre suivant:This method creates a DesignerTransaction automatically in the following order:

  1. La méthode appelle la IDesignerHost.CreateTransaction méthode pour créer un nouveau DesignerTransaction qui représente les modifications.The method calls the IDesignerHost.CreateTransaction method to create a new DesignerTransaction to represent the changes.

  2. La méthode appelle la IComponentChangeService.OnComponentChanging méthode pour indiquer que la transaction a commencé et que les modifications sont sur le lieu de se produire.The method calls the IComponentChangeService.OnComponentChanging method to indicate that the transaction has begun and the changes are about to occur.

  3. La méthode réinitialise la propriété à la valeur déterminée par l’ordre de vérification de cette méthode.The method resets the property to the value determined by this method's checking order.

  4. La méthode appelle la IComponentChangeService.OnComponentChanged méthode pour indiquer que les modifications ont été effectuées.The method calls the IComponentChangeService.OnComponentChanged method to indicate that the changes have occurred.

  5. La méthode appelle DesignerTransaction.Commit pour indiquer que la transaction est terminée.The method calls DesignerTransaction.Commit to indicate that the transaction is complete.

L’objectif de la transaction est de prendre Undo en Redo charge les fonctionnalités et.The purpose of the transaction is to support Undo and Redo functionality.

Notes pour les héritiers

Lorsque vous substituez cette méthode, elle doit définir la valeur de la propriété en appelant la méthode «SetMyProperty» appropriée que vous devez implémenter.When you override this method, it should set the value of the property by invoking the appropriate "SetMyProperty" method that you need to implement. Si la valeur spécifiée n’est pas valide, le composant doit lever une exception, qui est passée.If the value specified is not valid, the component should throw an exception, which is passed up. Vous devez concevoir la propriété de sorte qu’une méthode «GetMyProperty» (que vous avez implémentée) qui suit une méthode «SetMyProperty» retourne la valeur passée lorsque la méthode «SetMyProperty» ne lève pas d’exception.You should design the property so that a "GetMyProperty" method (that you have implemented) following a "SetMyProperty" method returns the value passed in when the "SetMyProperty" method does not throw an exception.

S’applique à

Voir aussi