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, affecte une autre valeur au composant.
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 -> unitPublic MustOverride Sub SetValue (component As Object, value As Object)Paramètres
- component
- Object
Composant dont la valeur de la propriété doit être définie.
- 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 dans l’ordre suivant :
La méthode appelle la IDesignerHost.CreateTransaction méthode pour en créer un pour DesignerTransaction 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 transmise. Vous devez concevoir la propriété de sorte qu’une méthode « GetMyProperty » (que vous avez implémentée) suivant une méthode « SetMyProperty » retourne la valeur transmise lorsque la méthode « SetMyProperty » ne lève pas d’exception.
