PropertyDescriptor.SetValue(Object, Object) Methode

Definitie

Wanneer deze wordt overschreven in een afgeleide klasse, stelt u de waarde van het onderdeel in op een andere waarde.

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)

Parameters

component
Object

Het onderdeel met de eigenschapswaarde die moet worden ingesteld.

value
Object

De nieuwe waarde.

Opmerkingen

Deze methode wordt doorgaans geïmplementeerd via weerspiegeling.

Met deze methode wordt automatisch een DesignerTransaction in de volgende volgorde gemaakt:

  1. Met de methode wordt de IDesignerHost.CreateTransaction methode aangeroepen om een nieuwe DesignerTransaction te maken om de wijzigingen weer te geven.

  2. Met de methode wordt de IComponentChangeService.OnComponentChanging methode aangeroepen om aan te geven dat de transactie is gestart en dat de wijzigingen op het punt staan.

  3. De methode stelt de eigenschap opnieuw in op de waarde die wordt bepaald door de controlevolgorde van deze methode.

  4. De methode roept de IComponentChangeService.OnComponentChanged methode aan om aan te geven dat de wijzigingen zijn opgetreden.

  5. De methode roept DesignerTransaction.Commit aan om aan te geven dat de transactie is voltooid.

Het doel van de transactie is om ondersteuning en Redo functionaliteit te biedenUndo.

Notities voor uitvoerders

Wanneer u deze methode overschrijft, moet u de waarde van de eigenschap instellen door de juiste methode SetMyProperty aan te roepen die u moet implementeren. Als de opgegeven waarde ongeldig is, moet het onderdeel een uitzondering genereren, die wordt doorgegeven. U moet de eigenschap zo ontwerpen dat een methode GetMyProperty (die u hebt geïmplementeerd) na een methode SetMyProperty de waarde retourneert die is doorgegeven wanneer de methode 'SetMyProperty' geen uitzondering genereert.

Van toepassing op

Zie ook