PropertyDescriptor.ResetValue(Object) Methode

Definition

Setzt beim Überschreiben in einer abgeleiteten Klasse den Wert dieser Komponenteneigenschaft auf den Standardwert zurück.

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)

Parameter

component
Object

Die Komponente mit dem Eigenschaftswert, der auf den Standardwert zurückgesetzt werden soll.

Hinweise

In der Regel wird diese Methode durch Reflektion implementiert.

Diese Methode bestimmt den Wert, auf den die Eigenschaft zurückgesetzt werden soll, in der folgenden Rangfolge:

  1. Es gibt eine Schatteneigenschaft für diese Eigenschaft.

  2. Für diese DefaultValueAttribute Eigenschaft gibt es eine .

  3. Sie haben eine ResetMyProperty-Methode implementiert, wobei "MyProperty" der Name der Eigenschaft ist, die Sie an sie übergeben.

Diese Methode erstellt DesignerTransaction automatisch in der folgenden Reihenfolge:

  1. Die -Methode ruft die IDesignerHost.CreateTransaction -Methode auf, um einen neuen zu DesignerTransaction erstellen, der die Änderungen repräsentiert.

  2. Die -Methode ruft die IComponentChangeService.OnComponentChanging -Methode auf, um anzugeben, dass die Transaktion gestartet wurde und die Änderungen in Arbeit sind.

  3. Die -Methode setzt die -Eigenschaft auf den Wert zurück, der von der Prüf reihenfolge dieser Methode bestimmt wird.

  4. Die -Methode ruft die IComponentChangeService.OnComponentChanged -Methode auf, um anzugeben, dass die Änderungen aufgetreten sind.

  5. Die -Methode ruft DesignerTransaction.Commit auf, um anzugeben, dass die Transaktion abgeschlossen ist.

Der Zweck der Transaktion ist die Unterstützung Undo und Redo Funktionalität.

Hinweise für Ausführende

Beim Überschreiben in einer abgeleiteten Klasse sucht diese Methode nach einem DefaultValueAttribute . Wenn eine gefunden wird, legt sie den Wert der -Eigenschaft auf die DefaultValueAttribute gefundene fest. Wenn diese Methode kein DefaultValueAttribute findet, sucht sie nach einer ResetMyProperty-Methode, die Sie implementieren müssen. Wenn dies gefunden wird, ruft ResetValue(Object) die Methode es auf. Wenn ResetValue(Object) die von Ihnen implementierte ResetMyProperty-Methode oder die Methode DefaultValueAttribute "ResetMyProperty" nicht finden kann, wird kein Vorgang durchgeführt.

Gilt für

Siehe auch