DependencyObject.SetValue(DependencyProperty, Object) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml
Modifica

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

dp
DependencyProperty

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.

Si applica a

Vedi anche