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

In der Regel wird diese Methode durch Reflektion implementiert.Typically, this method is implemented through reflection.

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

  1. Die-Methode ruft IDesignerHost.CreateTransaction die-Methode auf, DesignerTransaction um eine neue zu erstellen, die die Änderungen darstellt.The method calls the IDesignerHost.CreateTransaction method to create a new DesignerTransaction to represent the changes.

  2. Die-Methode ruft IComponentChangeService.OnComponentChanging die-Methode auf, um anzugeben, dass die Transaktion begonnen hat und die Änderungen im Begriff sind.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 zurück, der durch die Überprüfungs Reihenfolge dieser Methode bestimmt wird.The method resets the property to the value determined by this method's checking order.

  4. Die-Methode ruft IComponentChangeService.OnComponentChanged die-Methode auf, um anzugeben, dass die Änderungen aufgetreten sind.The method calls the IComponentChangeService.OnComponentChanged method to indicate that the changes have occurred.

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

Der Zweck der Transaktion besteht darin, die Undo Funktionen Redo und zu unterstützen.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 festlegen, indem Sie die entsprechende SetMyProperty-Methode aufrufen, 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 ungültig ist, sollte die Komponente eine Ausnahme auslösen, die übergeben wird.If the value specified is not valid, the component should throw an exception, which is passed up. Sie sollten die-Eigenschaft so entwerfen, dass eine "GetMyProperty"-Methode (die Sie implementiert haben), die auf eine "SetMyProperty"-Methode folgt, den Wert zurückgibt, der übergeben wird, wenn die SetMyProperty-Methode 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