FrameworkElement.SetBinding(DependencyProperty, BindingBase) Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Collega un'associazione a un FrameworkElement usando l'oggetto binding fornito.

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

public void SetBinding(DependencyProperty dp, BindingBase binding);

function setBinding(dp, binding)

Public Sub SetBinding (dp As DependencyProperty, binding As BindingBase)

Parametri

dp

DependencyProperty

Identificatore della proprietà di dipendenza della proprietà associata ai dati.

binding

BindingBase

Associazione da utilizzare per la proprietà .

Esempio

In questo esempio viene stabilita un'associazione a una proprietà di dipendenza su un oggetto chiamando SetBinding.

// Create the source string.
string s = "Hello";

// Create the binding description.
Binding b = new Binding();
b.Mode = BindingMode.OneTime;
b.Source = s;

// Attach the binding to the target.
TextBlock MyText = new TextBlock();
MyText.SetBinding(TextBlock.TextProperty, b);

Commenti

Questo metodo è un metodo pratico che chiama BindingOperations.SetBinding, passando l'istanza corrente come target parametro.

Il tipo del parametro è BindingBase per motivi di compatibilità, ma nella Windows Runtime si passa sempre un'istanza di bindingbinding. L'oggetto Binding è derivato da BindingBase.

Il dp parametro accetta un identificatore della proprietà di dipendenza. Per altre info sulle proprietà di dipendenza e sul modo in cui un valore DependencyProperty funge da identificatore, vedi Panoramica delle proprietà di dipendenza.

È possibile eseguire il binding alle proprietà di dipendenza personalizzate o alle proprietà associate personalizzate, ovvero l'identificatore passato perché il dp parametro non deve essere una proprietà definita Windows Runtime.

Se un'associazione creata dal codice sarà in grado di usare un contesto dati che agisce dipende dalle considerazioni sulla durata degli oggetti. Ad esempio, un valore DataContext impostato da XAML non sarà disponibile finché non viene analizzato il codice XAML. In tal caso, è possibile usare un gestore caricato per aggiungere associazioni dal codice.

Nota

La chiamata al metodo e il SetBinding 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( ad Grid.Row esempio, 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.

Vedi anche

• Binding
• BindingOperations
• Informazioni approfondite sul data binding
• Panoramica delle proprietà di dipendenza