FrameworkElement.SetBinding(DependencyProperty, BindingBase) Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml

Attache une liaison à un FrameworkElement à l’aide de l’objet de liaison fourni.

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)

Paramètres

dp

DependencyProperty

Identificateur de propriété de dépendance de la propriété liée aux données.

binding

BindingBase

Liaison à utiliser pour la propriété .

Exemples

Cet exemple établit une liaison à une propriété de dépendance sur un objet en appelant 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);

Remarques

Cette méthode est une méthode pratique qui appelle BindingOperations.SetBinding, en passant le instance actuel comme target paramètre.

Le type du binding paramètre est BindingBase pour des raisons de compatibilité, mais dans le Windows Runtime vous passez toujours une instance de liaison. Binding est dérivé de BindingBase.

Le dp paramètre prend un identificateur de propriété de dépendance. Pour plus d’informations sur les propriétés de dépendance et sur la façon dont une valeur DependencyProperty sert d’identificateur, consultez Vue d’ensemble des propriétés de dépendance.

Vous pouvez lier des propriétés de dépendance personnalisées ou des propriétés jointes personnalisées. L’identificateur que vous passez en tant que dp paramètre n’a pas besoin d’être une propriété Windows Runtime définie.

La possibilité pour une liaison créée à partir du code d’utiliser un contexte de données actif dépend des considérations relatives à la durée de vie de l’objet. Par exemple, une valeur DataContext définie à partir de XAML ne sera pas disponible tant que le code XAML n’est pas analysé. Dans ce cas, vous pouvez utiliser un gestionnaire Chargé pour ajouter des liaisons à partir du code.

Notes

L’appel de la méthode et le SetBinding passage d’un nouvel objet Binding ne suppriment pas nécessairement une liaison existante. Au lieu de cela, vous devez d’abord appeler la méthode DependencyObject.ClearValue , puis appeler SetBinding.

Liaison à des propriétés jointes

Vous pouvez placer des liaisons de données sur toutes les propriétés jointes prises en charge par un objet cible. Techniquement, un DependencyObject prend en charge toutes les propriétés jointes possibles, mais vous définissez généralement une liaison uniquement sur une propriété jointe qui est pertinente pour cet objet ou votre scénario. Par exemple, vous définissez une liaison sur Grid.Row uniquement si vous prévoyez que l’élément cible a un parent Grid qui utilisera ces informations. Spécifiez le paramètre dp comme identificateur de propriété de dépendance qui existe sur la classe propriétaire de la Grid.Row propriété jointe (par exemple, cet identificateur est Grid.RowProperty). Vous ne trouverez pas cet identificateur sur la cible, car il s’agit d’une propriété jointe. Pour plus d’informations sur les propriétés jointes, consultez Vue d’ensemble des propriétés jointes.

Voir aussi

• Binding
• BindingOperations
• Présentation détaillée de la liaison de données
• Vue d’ensemble des propriétés de dépendance