PropertyDescriptor.SetValue(Object, Object) Méthode

Définition

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 -> unit
Public 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 :

  1. La méthode appelle la IDesignerHost.CreateTransaction méthode pour en créer un pour DesignerTransaction représenter les modifications.

  2. 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.

  3. La méthode réinitialise la propriété à la valeur déterminée par l’ordre de vérification de cette méthode.

  4. La méthode appelle la IComponentChangeService.OnComponentChanged méthode pour indiquer que les modifications se sont produites.

  5. 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.

S’applique à

Voir aussi