PropertyDescriptor.SetValue(Object, Object) PropertyDescriptor.SetValue(Object, Object) PropertyDescriptor.SetValue(Object, Object) PropertyDescriptor.SetValue(Object, Object) Method

Definition

Legt beim Überschreiben in einer abgeleiteten Klasse den Wert der Komponente auf einen anderen Wert fest.When overridden in a derived class, sets the value of the component to a different value.

public:
 abstract void SetValue(System::Object ^ component, System::Object ^ value);
public abstract void SetValue (object component, object value);
abstract member SetValue : obj * obj -> unit
Public MustOverride Sub SetValue (component As Object, value As Object)

Parameter

component
Object Object Object Object

Die Komponente mit dem Eigenschaftswert, der festgelegt werden soll.The component with the property value that is to be set.

value
Object Object Object Object

Der neue Wert.The new value.

Hinweise

Diese Methode wird in der Regel mithilfe von Reflektion implementiert.Typically, this method is implemented through reflection.

Diese Methode erstellt eine DesignerTransaction automatisch in der folgenden Reihenfolge:This method creates a DesignerTransaction automatically in the following order:

  1. Ruft die Methode die IDesignerHost.CreateTransaction Methode zum Erstellen eines neuen DesignerTransaction zur Darstellung der Änderungen.The method calls the IDesignerHost.CreateTransaction method to create a new DesignerTransaction to represent the changes.

  2. Ruft die Methode die IComponentChangeService.OnComponentChanging Methode, um anzugeben, dass die Transaktion gestartet wurde und die Änderungen sind im Begriff, die auftreten.The method calls the IComponentChangeService.OnComponentChanging method to indicate that the transaction has begun and the changes are about to occur.

  3. Die Methode setzt die Eigenschaft auf den Wert, der durch diese Methode die typüberprüfung Reihenfolge bestimmt, zurück.The method resets the property to the value determined by this method's checking order.

  4. Ruft die Methode die IComponentChangeService.OnComponentChanged Methode, um anzugeben, dass die Änderungen vorgenommen wurden.The method calls the IComponentChangeService.OnComponentChanged method to indicate that the changes have occurred.

  5. Ruft die Methode DesignerTransaction.Commit um anzugeben, dass die Transaktion abgeschlossen ist.The method calls DesignerTransaction.Commit to indicate that the transaction is complete.

Der Zweck der Transaktion ist zur Unterstützung Undo und Redo Funktionalität.The purpose of the transaction is to support Undo and Redo functionality.

Hinweise für Vererber

Wenn Sie diese Methode überschreiben, sollte sie den Wert der Eigenschaft festgelegt, durch den Aufruf der entsprechenden "SetMyProperty"-Methode, die Sie implementieren müssen.When you override this method, it should set the value of the property by invoking the appropriate "SetMyProperty" method that you need to implement. Wenn der angegebene Wert nicht gültig ist, sollte die Komponente eine Ausnahme auszulösen, die nach oben weitergegeben wird.If the value specified is not valid, the component should throw an exception, which is passed up. Entwerfen Sie die Eigenschaft, damit eine "GetMyProperty-Methode"-Methode (die Sie implementiert haben) nach einer Methode "SetMyProperty" gibt den Wert übergeben werden, wenn die Methode "SetMyProperty" keine Ausnahme auslöst.You should design the property so that a "GetMyProperty" method (that you have implemented) following a "SetMyProperty" method returns the value passed in when the "SetMyProperty" method does not throw an exception.

Gilt für:

Siehe auch