Partager via


BindingOperations.SetBinding Méthode

Définition

Associe une liaison à une propriété cible sur un objet cible. Cette méthode est le code équivalent à l’utilisation d’une extension de balisage {Binding} dans le balisage 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)

Paramètres

target
DependencyObject

Objet qui doit être la cible de la liaison évaluée.

dp
DependencyProperty

Propriété sur la cible à lier, spécifiée par son identificateur. Ces identificateurs sont généralement disponibles en tant que propriétés statiques en lecture seule sur le type qui définit l’objet cible ou l’un de ses types de base. Vous pouvez également lier des propriétés jointes, mais consultez Remarques.

binding
BindingBase

Liaison à affecter à la propriété cible. Cette liaison doit être initialisée : les propriétés de liaison importantes telles que Path doivent déjà être définies avant de la passer en tant que paramètre.

Remarques

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.

BindingOperations.SetBinding est une méthode d’utilitaire statique qui fait essentiellement la même chose que FrameworkElement.SetBinding. Il est plus courant d’utiliser FrameworkElement.SetBinding, car il s’agit d’une méthode instance. Une différence importante cependant est que BindingOperations.SetBinding peut utiliser une valeur cible de n’importe quel DependencyObject, tandis que FrameworkElement.SetBinding ne peut, par définition, être utilisé que pour une cible FrameworkElement . Cela n’a généralement pas d’importance pour la plupart des classes Windows Runtime utilisées pour l’interface utilisateur XAML, car il s’agit principalement de sous-classes FrameworkElement de toute façon. Toutefois, la distinction peut être importante si vous ciblez des liaisons sur vos propres classes personnalisées qui dérivent de DependencyObject ou d’UIElement.

Notes

L’appel de la méthode SetBinding et le passage d’un nouvel objet Binding ne supprime 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 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