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

Diese Methode bestimmt den Wert, um die Eigenschaft in der folgenden Reihenfolge der Rangfolge zurückzusetzen:

  1. Für diese Eigenschaft gibt es eine schattenierte 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 zu erstellen, um die Änderungen darzustellen.

  2. Die Methode ruft die IComponentChangeService.OnComponentChanging Methode auf, um anzugeben, dass die Transaktion begonnen hat, und die Änderungen werden ausgeführt.

  3. Die Methode setzt die Eigenschaft auf den Wert zurück, der durch die Überprüfungsreihenfolge 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 eine abgeleitete Klasse überschrieben wird, sucht diese Methode nach einer DefaultValueAttribute. Wenn ein Objekt gefunden wird, legt er den Wert der Eigenschaft auf die DefaultValueAttribute gefundene Eigenschaft fest. Wenn diese Methode keine gefunden DefaultValueAttributewird, 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 DefaultValueAttribute von Ihnen implementierte "ResetMyProperty"-Methode nicht gefunden wird, wird kein Vorgang ausgeführt.

Gilt für:

Siehe auch