PropertyDescriptor.ResetValue(Object) Methode

Definition

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, wird der Wert für diese Eigenschaft der Komponente auf den Standardwert zurückgesetzt.

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 Spiegelung implementiert.

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

  1. Für diese Eigenschaft gibt es eine schattierte Eigenschaft.

  2. Für diese Eigenschaft gibt es eine 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 DesignerTransaction in der folgenden Reihenfolge:

  1. Die Methode ruft die IDesignerHost.CreateTransaction Methode auf, um eine neue DesignerTransaction zum Darstellen der Änderungen zu erstellen.

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

  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

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, wird nach einer DefaultValueAttribute. Wenn eine gefunden wird, legt sie den Wert der Eigenschaft auf die DefaultValueAttribute gefundene Eigenschaft fest. Wenn diese Methode keine finden DefaultValueAttributekann, wird nach einer "ResetMyProperty"-Methode gesucht, die Sie implementieren müssen. Wenn dies gefunden wird, ruft die ResetValue(Object) Methode sie auf. Wenn ResetValue(Object) sie eine DefaultValueAttribute von Ihnen implementierte Methode oder eine "ResetMyProperty"-Methode nicht finden kann, führt sie keinen Vorgang aus.

Gilt für:

Weitere Informationen