PropertyDescriptor.ResetValue(Object) Metoda

Definicja

Gdy jest zastępowany w klasie pochodnej, resetuje wartość tej właściwości składnika do wartości domyślnej.When overridden in a derived class, resets the value for this property of the component to the default value.

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)

Parametry

component
Object

Składnik z wartością właściwości, która ma zostać przywrócona do wartości domyślnej.The component with the property value that is to be reset to the default value.

Uwagi

Zazwyczaj ta metoda jest implementowana poprzez odbicie.Typically, this method is implemented through reflection.

Ta metoda określa wartość resetowania właściwości do wartości w następującej kolejności:This method determines the value to reset the property to in the following order of precedence:

  1. Istnieje właściwość shadowd dla tej właściwości.There is a shadowed property for this property.

  2. Istnieje DefaultValueAttribute dla tej właściwości.There is a DefaultValueAttribute for this property.

  3. Zaimplementowano metodę "ResetMyProperty", gdzie "noproperty" jest nazwą przekazanej do niej właściwości.There is a "ResetMyProperty" method that you have implemented, where "MyProperty" is the name of the property you pass to it.

Ta metoda tworzy DesignerTransaction automatycznie w następującej kolejności:This method creates a DesignerTransaction automatically in the following order:

  1. Metoda wywołuje IDesignerHost.CreateTransaction metodę w celu utworzenia nowej DesignerTransaction do reprezentowania zmian.The method calls the IDesignerHost.CreateTransaction method to create a new DesignerTransaction to represent the changes.

  2. Metoda wywołuje IComponentChangeService.OnComponentChanging metodę w celu wskazania, że transakcja została rozpoczęta i zmiany zostaną wykonane.The method calls the IComponentChangeService.OnComponentChanging method to indicate that the transaction has begun and the changes are about to occur.

  3. Metoda resetuje właściwość do wartości ustalonej przez kolejność sprawdzania tej metody.The method resets the property to the value determined by this method's checking order.

  4. Metoda wywołuje IComponentChangeService.OnComponentChanged metodę w celu wskazania, że zmiany zostały wprowadzone.The method calls the IComponentChangeService.OnComponentChanged method to indicate that the changes have occurred.

  5. Metoda wywołuje DesignerTransaction.Commit , aby wskazać, że transakcja została ukończona.The method calls DesignerTransaction.Commit to indicate that the transaction is completed.

Celem transakcji jest wsparcie Undo i Redo funkcjonalność.The purpose of the transaction is to support Undo and Redo functionality.

Uwagi dotyczące implementowania

Gdy jest zastępowany w klasie pochodnej, ta metoda szuka DefaultValueAttribute .When overridden in a derived class, this method looks for a DefaultValueAttribute. Jeśli znajdzie, ustawia wartość właściwości na DefaultValueAttribute znalezioną.If it finds one, it sets the value of the property to the DefaultValueAttribute it found. Jeśli ta metoda nie może znaleźć DefaultValueAttribute , szuka metody "ResetMyProperty", która ma być zaimplementowana.If this method cannot find a DefaultValueAttribute, it looks for a "ResetMyProperty" method that you need to implement. W przypadku znalezienia tej ResetValue(Object) metody metoda wywołuje ją.If this is found, the ResetValue(Object) method invokes it. Jeśli ResetValue(Object) nie można znaleźć DefaultValueAttribute metody lub "ResetMyProperty", która została zaimplementowana, nie wykonuje operacji.If ResetValue(Object) cannot find a DefaultValueAttribute or a "ResetMyProperty" method that you implemented, it does not perform an operation.

Dotyczy

Zobacz też