DependencyObject.SetValue(DependencyProperty, 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.
Imposta il valore locale di una proprietà di dipendenza in un oggetto DependencyObject.
public:
virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;void SetValue(DependencyProperty const& dp, IInspectable const& value);public void SetValue(DependencyProperty dp, object value);function setValue(dp, value)Public Sub SetValue (dp As DependencyProperty, value As Object)Parametri
Identificatore della proprietà di dipendenza da impostare.
- value
-
Object
Platform::Object
IInspectable
Nuovo valore locale.
Commenti
Se il tipo di valore specificato non corrisponde al tipo dichiarato per la proprietà di dipendenza come originariamente registrato, viene generata un'eccezione.
Non tutte le proprietà Windows Runtime usate da XAML sono proprietà di dipendenza. Un identificatore DependencyProperty deve esistere e deve essere disponibile come proprietà pubblica di un oggetto proprietario, in genere l'oggetto che ha registrato la proprietà.
Per il codice utente dell'app, la chiamata a SetValue non è in genere necessaria. In genere, una proprietà di dipendenza Windows Runtime o una proprietà di dipendenza personalizzata ha una proprietà convenzionale che la esegue il wrapping e è sufficiente impostare il valore della proprietà tramite un utilizzo con punti convenzionale. I casi in cui è comunque possibile usare SetValue sono:
- Si definisce una proprietà di dipendenza personalizzata. Si chiamerà SetValue come parte della definizione della funzione di accesso del set di proprietà personalizzata per un utilizzo di proprietà convenzionale. Per altre info, vedi Proprietà di dipendenza personalizzate.
- Si definisce un callback o si trova in un altro ambito in cui si sta già passando un identificatore DependencyProperty e è possibile che esista più proprietà di dipendenza con cui si vuole interagire con tale ambito. In questi casi è probabilmente più semplice chiamare SetValue, passando l'identificatore.