FrameworkElement.SetBinding(DependencyProperty, BindingBase) 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.
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
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 l’instance actuelle en tant que target paramètre.
Le type du paramètre est BindingBase pour des raisons de binding compatibilité, mais dans la Windows Runtime vous transmettez 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 la 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 transmettez, car le dp paramètre n'a pas besoin d'être une propriété Windows Runtime définie.
Si une liaison créée à partir du code sera en mesure d’utiliser un contexte de données agissant 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.
Note
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 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 (par Grid.Row 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 la vue d’ensemble des propriétés jointes.