Partage via


FrameworkElement.SetBinding(DependencyProperty, BindingBase) Méthode

Définition

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);
'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)

Remarques

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

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

Le paramètre dp 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 paramètre dp n’a pas besoin d’être une propriété Windows Runtime définie.

Le fait qu’une liaison créée à partir du code puisse 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 SetBinding et le 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 devez définir 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 propriété jointe (pour l’exemple Grid.Row , 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.

S’applique à

Voir aussi