PropertyDescriptor.SetValue(Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
En cas de substitution dans une classe dérivée, définit la valeur du composant sur une valeur différente.
public:
abstract void SetValue(System::Object ^ component, System::Object ^ value);public abstract void SetValue(object component, object value);abstract member SetValue : obj * obj -> unitPublic MustOverride Sub SetValue (component As Object, value As Object)Paramètres
- component
- Object
Composant avec la valeur de propriété à définir.
- value
- Object
Nouvelle valeur.
Remarques
En règle générale, cette méthode est implémentée par réflexion.
Cette méthode crée automatiquement un DesignerTransaction ordre suivant :
La méthode appelle la IDesignerHost.CreateTransaction méthode pour créer un nouveau DesignerTransaction pour représenter les modifications.
La méthode appelle la IComponentChangeService.OnComponentChanging méthode pour indiquer que la transaction a commencé et que les modifications sont sur le point de se produire.
La méthode réinitialise la propriété à la valeur déterminée par l’ordre de vérification de cette méthode.
La méthode appelle la IComponentChangeService.OnComponentChanged méthode pour indiquer que les modifications se sont produites.
La méthode appelle DesignerTransaction.Commit pour indiquer que la transaction est terminée.
L’objectif de la transaction est de prendre en charge Undo et Redo de fonctionnalités.
Notes pour les responsables de l’implémentation
Lorsque vous remplacez 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. Si la valeur spécifiée n’est pas valide, le composant doit lever une exception, qui est passée. Vous devez concevoir la propriété afin qu’une méthode « GetMyProperty » (que vous avez implémentée) après une méthode « SetMyProperty » retourne la valeur passée lorsque la méthode « SetMyProperty » ne lève pas d’exception.