PropertyDescriptor.SetValue(Object, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Quando è sottoposto a override in una classe derivata, consente di impostare il valore del componente su un valore differente.
public:
abstract void SetValue(System::Object ^ component, System::Object ^ value);
public abstract void SetValue (object component, 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)
Parametri
- component
- Object
Componente con il valore di proprietà da impostare.
- value
- Object
Nuovo valore.
Commenti
In genere, questo metodo viene implementato tramite reflection.
Questo metodo crea automaticamente un DesignerTransaction oggetto nell'ordine seguente:
Il metodo chiama il IDesignerHost.CreateTransaction metodo per creare un nuovo DesignerTransaction oggetto per rappresentare le modifiche.
Il metodo chiama il metodo per indicare che la IComponentChangeService.OnComponentChanging transazione è iniziata e le modifiche si verificano.
Il metodo reimposta la proprietà sul valore determinato dall'ordine di controllo del metodo.
Il metodo chiama il IComponentChangeService.OnComponentChanged metodo per indicare che le modifiche si sono verificate.
Il metodo chiama DesignerTransaction.Commit per indicare che la transazione è completa.
Lo scopo della transazione è supportare e Redo
funzionalitàUndo
.
Note per gli implementatori
Quando si esegue l'override di questo metodo, deve impostare il valore della proprietà richiamando il metodo "SetMyProperty" appropriato che è necessario implementare. Se il valore specificato non è valido, il componente deve generare un'eccezione, che viene passata. È consigliabile progettare la proprietà in modo che un metodo "GetMyProperty" (implementato) seguendo un metodo "SetMyProperty" restituisce il valore passato quando il metodo "SetMyProperty" non genera un'eccezione.