Teilen über


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 in der folgenden Rangfolge zurückgesetzt werden soll:

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

  2. Für diese Eigenschaft ist ein vorhanden DefaultValueAttribute .

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

Diese Methode erstellt automatisch in DesignerTransaction der folgenden Reihenfolge:

  1. Die -Methode ruft die IDesignerHost.CreateTransaction -Methode auf, um eine neue DesignerTransaction zur Darstellung der Änderungen zu erstellen.

  2. Die -Methode ruft die IComponentChangeService.OnComponentChanging -Methode auf, um anzugeben, dass die Transaktion begonnen hat und die Änderungen im Entstehen sind.

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

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

  5. Die -Methode ruft auf DesignerTransaction.Commit , 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, wird der Wert der -Eigenschaft auf die DefaultValueAttribute gefundene festgelegt. Wenn diese Methode keine DefaultValueAttributefindet, sucht sie nach einer "ResetMyProperty"-Methode, die Sie implementieren müssen. Wenn dies gefunden wird, ruft die ResetValue(Object) -Methode sie auf. Wenn ResetValue(Object) eine oder eine DefaultValueAttribute "ResetMyProperty"-Methode, die Sie implementiert haben, nicht gefunden werden kann, wird kein Vorgang ausgeführt.

Gilt für:

Weitere Informationen