PropertyDescriptor.ResetValue(Object) Méthode

Définition

Espace de noms:
System.ComponentModel
Assembly:
System.dll
Assembly:
netstandard.dll

En cas de substitution dans une classe dérivée, réinitialise la valeur de cette propriété du composant à la valeur par défaut.

public:
 abstract void ResetValue(System::Object ^ component);
public abstract void ResetValue(object component);
abstract member ResetValue : obj -> unit
Public MustOverride Sub ResetValue (component As Object)

Paramètres

component
Object

Composant dont la valeur de propriété doit être réinitialisée à la valeur par défaut.

Remarques

En règle générale, cette méthode est implémentée par réflexion.

Cette méthode détermine la valeur à laquelle réinitialiser la propriété dans l’ordre de priorité suivant :

  1. Il existe une propriété ombrée pour cette propriété.

  2. Il y a une DefaultValueAttribute pour cette propriété.

  3. Il existe une méthode « ResetMyProperty » que vous avez implémentée, où « MyProperty » est le nom de la propriété que vous lui transmettez.

Cette méthode crée automatiquement un DesignerTransaction ordre suivant :

  1. La méthode appelle la IDesignerHost.CreateTransaction méthode pour créer un nouveau DesignerTransaction pour 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

En cas de substitution dans une classe dérivée, cette méthode recherche un DefaultValueAttribute. S’il en trouve un, il définit la valeur de la propriété sur celle-ci DefaultValueAttribute trouvée. Si cette méthode ne trouve pas de DefaultValueAttributeméthode, elle recherche une méthode « ResetMyProperty » que vous devez implémenter. Si elle est trouvée, la ResetValue(Object) méthode l’appelle. Si ResetValue(Object) vous ne trouvez pas de DefaultValueAttribute méthode « ResetMyProperty » que vous avez implémentée, elle n’effectue pas d’opération.

S’applique à

Voir aussi