FrameworkElement.SetBinding(DependencyProperty, BindingBase) Metodo

Definizione

Spazio dei nomi:

Windows.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 usare per la proprietà.

Esempio

In questo esempio viene stabilita un'associazione a una proprietà di dipendenza in 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);

'Create the source string 
Dim s As String = "Hello"

'Create the binding description 
Dim b As New Binding()
b.Mode = BindingMode.OneTime
b.Source = s

'Attach the binding to the target 
Dim MyText As New TextBlock()
MyText.SetBinding(TextBlock.TextProperty, b)

Commenti

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

Il tipo del parametro di associazione è BindingBase per motivi di compatibilità, ma nella Windows Runtime si passa sempre un'istanza di binding. L'associazione deriva da BindingBase.

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

È 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.

Se un'associazione creata dal codice sarà in grado di usare un contesto di 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 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
• BindingOperations
• Informazioni approfondite sul data binding
• Panoramica delle proprietà di dipendenza