BindingOperations.SetBinding 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.
Associa un binding a una proprietà di destinazione in un oggetto di destinazione. Questo metodo è il codice equivalente 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.
Proprietà nella destinazione da associare, specificata dal relativo identificatore. Questi identificatori sono in genere disponibili come proprietà statiche di sola lettura sul tipo che definisce l'oggetto di destinazione o uno dei relativi tipi di base. È anche possibile eseguire l'associazione alle proprietà associate, ma vedere La sezione Note.
- binding
- BindingBase
Associazione da assegnare alla proprietà di destinazione. Questa associazione deve essere inizializzata : importanti proprietà di associazione, ad esempio Path , devono essere già impostate prima di passarla come parametro.
Commenti
È possibile eseguire il binding alle proprietà di dipendenza personalizzate o alle proprietà associate personalizzate, l'identificatore passato perché il parametro dp non deve essere una proprietà definita Windows Runtime.
BindingOperations.SetBinding è un metodo di utilità statica ed esegue fondamentalmente la stessa operazione di FrameworkElement.SetBinding. È più comune usare FrameworkElement.SetBinding perché si tratta di 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 . In genere non è importante per la maggior parte delle classi Windows Runtime usate per l'interfaccia utente XAML, perché sono in genere sottoclassi FrameworkElement comunque. Tuttavia, la distinzione può essere importante se si fa riferimento a associazioni su classi personalizzate che derivano da DependencyObject o UIElement.
Nota
La chiamata al metodo SetBinding e il passaggio di un nuovo oggetto Binding non comporta necessariamente la rimozione di un'associazione esistente. È invece necessario chiamare prima il metodo DependencyObject.ClearValue , quindi chiamare SetBinding.
Associazione alle proprietà associate
È possibile inserire data binding su qualsiasi proprietà associata supportata da un oggetto di destinazione. Tecnicamente un DependencyObject supporta tutte le possibili proprietà associate, ma in genere si imposta solo un'associazione su una proprietà associata rilevante per tale oggetto o per lo 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 esistente nella classe proprietario della proprietà associata (per l'esempio Grid.Row , tale identificatore è Grid.RowProperty). L'identificatore nella destinazione non viene trovato perché si tratta di una proprietà associata. Per altre informazioni sulle proprietà associate, vedi Panoramica delle proprietà associate.