PropertyDescriptor.ResetValue-Methode

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

Namespace: System.ComponentModel
Assembly: System (in system.dll)

Syntax

'Declaration
Public MustOverride Sub ResetValue ( _
    component As Object _
)
'Usage
Dim instance As PropertyDescriptor
Dim component As Object

instance.ResetValue(component)

public abstract void ResetValue (
    Object component
)

public:
virtual void ResetValue (
    Object^ component
) abstract

public abstract void ResetValue (
    Object component
)

public abstract function ResetValue (
    component : Object
)

Parameter

• component
  Die Komponente mit dem Eigenschaftenwert, der auf den Standardwert zurückgesetzt werden soll.

Hinweise

Diese Methode wird i. d. R. über Reflektion implementiert.

Diese Methode bestimmt den Wert, auf den die Eigenschaft zurückgesetzt wird, nach den folgenden Prioritäten:

1. Es ist eine überschattete Eigenschaft für diese Eigenschaft vorhanden.

2. Es ist eine DefaultValueAttribute-Klasse für diese Eigenschaft vorhanden.

3. Es ist eine von Ihnen implementierte ResetMyProperty-Methode vorhanden, wobei "MyProperty" der Name der von Ihnen an die Methode übergebenen Eigenschaft ist.

Diese Methode erstellt automatisch eine DesignerTransaction-Klasse in der folgenden Reihenfolge:

1. Diese Methode ruft die IDesignerHost.CreateTransaction-Methode auf, um eine neue DesignerTransaction für die Darstellung der Änderungen zu erstellen.

2. Die Methode ruft die IComponentChangeService.OnComponentChanging-Methode auf, um den Beginn der Transaktion und das Eintreten von Änderungen anzugeben.

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

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

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

Diese Transaktion unterstützt die Undo-Funktion und die Redo-Funktion.

Hinweise für Erben Beim Überschreiben in einer abgeleiteten Klasse sucht diese Methode nach einer DefaultValueAttribute-Klasse. Wenn eine solche gefunden wird, legt sie den Wert der Eigenschaft auf die gefundene DefaultValueAttribute-Klasse fest. Wenn die Methode keine DefaultValueAttribute-Klasse findet, sucht sie nach einer "ResetMyProperty-Methode", die von Ihnen implementiert werden muss. Wenn diese Methode gefunden wird, wird sie von der ResetValue-Methode aufgerufen. Wenn ResetValue weder eine DefaultValueAttribute-Klasse noch eine von Ihnen implementierte "ResetMyProperty-Methode" findet, wird keine Operation ausgeführt.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

PropertyDescriptor-Klasse
PropertyDescriptor-Member
System.ComponentModel-Namespace
PropertyDescriptor-Klasse