BindingOperations.SetBinding Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Associe une liaison à une propriété cible sur un objet cible. Cette méthode est l’équivalent du code à l’aide 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.
Propriété sur la cible à lier, spécifiée par son identificateur. Ces identificateurs sont généralement disponibles sous forme de 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 établir une liaison à des propriétés jointes, mais voir 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 transmettre 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 et 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 d’instance. Une différence importante cependant est que BindingOperations.SetBinding peut utiliser une valeur cible de n’importe quel DependencyObject, tandis que FrameworkElement.SetBinding peut uniquement être utilisé 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 elles sont principalement des sous-classes FrameworkElement de toute façon. Mais la distinction peut être importante si vous ciblez des liaisons sur vos propres classes personnalisées qui dérivent de DependencyObject ou UIElement.
Note
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 aux 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 n’avez généralement défini qu’une liaison sur une propriété jointe 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 possède 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 la vue d’ensemble des propriétés jointes.