Extension de balisage {Binding}

L’extension de balisage {Binding} est utilisée pour lier des propriétés sur des contrôles aux valeurs provenant d’une source de données telle que du code. L’extension de balisage {Binding} est convertie au moment du chargement XAML en une instance de la classe Binding . Cet objet de liaison obtient une valeur d’une propriété sur une source de données et l’envoie à la propriété sur le contrôle. L’objet de liaison peut éventuellement être configuré pour observer les modifications apportées à la valeur de la propriété de source de données et se mettre à jour en fonction de ces modifications. Il peut également être configuré pour envoyer (push) des modifications à la valeur de contrôle vers la propriété source. La propriété qui est la cible d’une liaison de données doit être une propriété de dépendance. Pour plus d’informations, consultez la vue d’ensemble des propriétés de dépendance.

{Binding} a la même priorité de propriété de dépendance qu’une valeur locale et la définition d’une valeur locale dans le code impératif supprime l’effet de n’importe quel {Binding} défini dans le balisage.

Utilisation des attributs XAML

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Chemin de la propriété

Le chemin d’accès décrit la propriété à laquelle vous effectuez une liaison (la propriété source). Le chemin d’accès est un paramètre positionnel, ce qui signifie que vous pouvez utiliser le nom du paramètre explicitement ({Binding Path=EmployeeID}), ou vous pouvez le spécifier comme premier paramètre non nommé ({Binding EmployeeID}).

Le type de chemin d’accès est un chemin de propriété, qui est une chaîne qui prend la valeur d’une propriété ou d’une sous-propriété de votre type personnalisé ou d’un type d’infrastructure. Le type peut être, mais n’a pas besoin d’être, un DependencyObject. Les étapes d’un chemin de propriété sont délimitées par des points (.) et vous pouvez inclure plusieurs délimiteurs pour parcourir les sous-propriétés successives. Utilisez le délimiteur de points, quel que soit le langage de programmation utilisé pour implémenter l’objet lié.

Par exemple, pour lier l’interface utilisateur à la propriété prénom d’un objet employee, votre chemin de propriété peut être « Employee.FirstName ». Si vous liez un contrôle d’éléments à une propriété qui contient les dépendants d’un employé, votre chemin de propriété peut être « Employee.Dependents », et le modèle d’élément du contrôle d’éléments s’occuperait de l’affichage des éléments dans « Dépendants ».

Si la source de données est une collection, un chemin de propriété peut spécifier des éléments dans la collection en fonction de leur position ou de leur index. Par exemple, « Teams[0]. Joueurs », où le littéral « [] » entoure le « 0 » qui spécifie le premier élément d’une collection.

Lorsque vous utilisez une liaison ElementName à un DependencyObject existant, vous pouvez utiliser des propriétés jointes dans le cadre du chemin de propriété. Pour lever l’ambiguïté d’une propriété jointe afin que le point intermédiaire du nom de la propriété jointe ne soit pas considéré comme une étape dans un chemin de propriété, placez les parenthèses autour du nom de la propriété jointe qualifiée par le propriétaire ; par exemple, (AutomationProperties.Name).

Un objet intermédiaire de chemin de propriété est stocké en tant qu’objet PropertyPath dans une représentation au moment de l’exécution, mais la plupart des scénarios n’auront pas besoin d’interagir avec un objet PropertyPath dans le code. Vous pouvez généralement spécifier les informations de liaison dont vous avez besoin à l’aide de XAML.

Pour plus d’informations sur la syntaxe de chaîne d’un chemin de propriété, des chemins de propriété dans les zones de fonctionnalités d’animation et la construction d’un objet PropertyPath, consultez la syntaxe de chemin d’accès à la propriété.

Propriétés de la classe Binding qui peut être définie avec {Binding}

{Binding} est illustré avec la syntaxe d’espace réservé bindingProperties , car il existe plusieurs propriétés en lecture/écriture d’une liaison qui peut être définie dans l’extension de balisage. Les propriétés peuvent être définies dans n’importe quel ordre avec des paires de valeurs propName=séparées par des virgules. Certaines des propriétés nécessitent des types qui n’ont pas de conversion de type. Elles nécessitent donc des extensions de balisage de leur propre imbrication dans { Binding}.

Remarque Si vous convertissez le balisage de {x :Bind} en {Binding}, tenez compte des différences dans les valeurs par défaut de la propriété Mode .

Converter, ConverterLanguage et ConverterLanguage sont tous liés au scénario de conversion d’une valeur ou d’un type à partir de la source de liaison en un type ou une valeur compatible avec la propriété cible de liaison. Pour plus d’informations et d’exemples, consultez la section « Conversions de données » de la liaison de données en profondeur.

Source, RelativeSource et ElementName spécifient une source de liaison, de sorte qu’elles s’excluent mutuellement.

Conseil Si vous devez spécifier une accolade unique pour une valeur, par exemple dans Path ou ConverterParameter, faites-la précéder d’une barre oblique inverse : . \{ Vous pouvez également placer la chaîne entière qui contient les accolades qui ont besoin d’échapper dans un ensemble de guillemets secondaires, par exemple ConverterParameter='{Mix}'.

Exemples

<!-- binding a UI element to a view model -->    
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

Le deuxième exemple définit quatre propriétés de liaison différentes : ElementName, Path, Mode et Converter. Le chemin d’accès dans ce cas est explicitement nommé en tant que propriété Binding . Le chemin d’accès est évalué à une source de liaison de données qui est un autre objet dans la même arborescence d’objets d’exécution, un curseur nommé sliderValueConverter.

Notez comment la valeur de la propriété Converter utilise une autre extension de balisage , {StaticResource} extension de balisage. Il existe donc deux utilisations d’extension de balisage imbriquées ici. L’élément interne est évalué en premier, de sorte qu’une fois la ressource obtenue, il existe un IValueConverter pratique (classe personnalisée instanciée par l’élément local:S2Formatter dans les ressources) que la liaison peut utiliser.

Prise en charge des outils

Microsoft IntelliSense dans Microsoft Visual Studio affiche les propriétés du contexte de données lors de la création de {Binding} dans l’éditeur de balisage XAML. Dès que vous tapez « {Binding », les propriétés de contexte de données appropriées pour Path sont affichées dans la liste déroulante. IntelliSense permet également d’utiliser les autres propriétés de Binding. Pour que cela fonctionne, vous devez disposer du contexte de données ou du contexte de données au moment du design dans la page de balisage. Go To Definition (F12) fonctionne également avec {Binding}. Vous pouvez également utiliser la boîte de dialogue de liaison de données.