DependencyObject.SetValue(DependencyProperty, Object) Metodo

Definizione

Spazio dei nomi:
Microsoft.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 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 ed è sufficiente impostare il valore della proprietà tramite un utilizzo tratteggiato convenzionale. I casi in cui è ancora possibile usare SetValue sono:

  • Si definisce una proprietà di dipendenza personalizzata. Verrà chiamato SetValue come parte della definizione della funzione di accesso del set di proprietà personalizzata per un utilizzo convenzionale delle proprietà. Per altre info, vedi Proprietà di dipendenza personalizzate.
  • Si sta definendo un callback o ci si trova in un altro ambito in cui si sta già passando un identificatore DependencyProperty ed è possibile che esista più di una proprietà di dipendenza con cui si vuole interagire in tale ambito. In questi casi è probabilmente più semplice chiamare SetValue, passando l'identificatore .

Si applica a

Vedi anche