BindingOperations.SetBinding Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Data

Associa un binding a una proprietà di destinazione in un oggetto di destinazione. Questo metodo equivale all'uso di un'estensione di markup {Binding} nel markup XAML.

 static void SetBinding(DependencyObject const& target, DependencyProperty const& dp, BindingBase const& binding);

public static void SetBinding(DependencyObject target, DependencyProperty dp, BindingBase binding);

function setBinding(target, dp, binding)

Public Shared Sub SetBinding (target As DependencyObject, dp As DependencyProperty, binding As BindingBase)

Parametri

target

DependencyObject

Oggetto che deve essere la destinazione dell'associazione valutata.

dp

DependencyProperty

Proprietà nella destinazione da associare, specificata dall'identificatore. Questi identificatori sono in genere disponibili come proprietà di sola lettura statiche sul tipo che definisce l'oggetto di destinazione o uno dei relativi tipi di base. È anche possibile associare alle proprietà associate, ma vedere Osservazioni.

binding

BindingBase

Associazione da assegnare alla proprietà di destinazione. Questa associazione deve essere inizializzata: le proprietà di associazione importanti, ad esempio Path , devono essere già impostate prima di passarla come parametro.

Commenti

È possibile associare alle proprietà di dipendenza personalizzate o alle proprietà associate personalizzate, l'identificatore passato come parametro dp non deve essere una proprietà definita Windows Runtime.

BindingOperations.SetBinding è un metodo di utilità statico ed esegue fondamentalmente la stessa cosa di FrameworkElement.SetBinding. È più comune usare FrameworkElement.SetBinding perché è un metodo di istanza. Una differenza importante è tuttavia che BindingOperations.SetBinding può usare un valore di destinazione di qualsiasi DependencyObject, mentre FrameworkElement.SetBinding può essere usato solo per una destinazione FrameworkElement . Questo non è in genere importante per la maggior parte delle classi Windows Runtime usate per l'interfaccia utente XAML, perché queste sono principalmente sottoclassi FrameworkElement comunque. Tuttavia, la distinzione può essere importante se si puntano alle associazioni nelle proprie classi personalizzate che derivano da DependencyObject o UIElement.

Nota

La chiamata al metodo SetBinding e il passaggio di un nuovo oggetto Binding non rimuove necessariamente un'associazione esistente. È invece necessario chiamare prima il metodo DependencyObject.ClearValue , quindi chiamare SetBinding.

Associazione alle proprietà associate

È possibile inserire i data binding in qualsiasi proprietà associata supportata da un oggetto di destinazione. Tecnicamente un dependencyObject supporta tutte le possibili proprietà associate, ma in genere si imposta un'associazione solo su una proprietà associata pertinente a tale oggetto o al proprio scenario. Ad esempio, si imposta un'associazione in Grid.Row solo se si prevede che l'elemento di destinazione abbia un elemento padre Grid che userà tali informazioni. Specificare il parametro dp come identificatore della proprietà di dipendenza presente nella classe proprietario della proprietà associata (per l'esempio Grid.Row, che identificatore è Grid.RowProperty). Non è possibile trovare tale identificatore nella destinazione perché è una proprietà associata. Per altre informazioni sulle proprietà associate, vedere Panoramica delle proprietà associate.

Vedi anche

• Binding
• Esempio di data binding XAML
• Informazioni approfondite sul data binding