Binding.Path Propriété

public:
 property System::Windows::PropertyPath ^ Path { System::Windows::PropertyPath ^ get(); void set(System::Windows::PropertyPath ^ value); };

public System.Windows.PropertyPath Path { get; set; }

member this.Path : System.Windows.PropertyPath with get, set

Public Property Path As PropertyPath

Valeur de propriété

Chemin d’accès à la source de liaison. La valeur par défaut est null.

Exemples

L’exemple suivant montre un déclencheur de style qui crée un ToolTip message d’erreur de validation. La valeur du setter est liée au contenu d’erreur de l’élément actif TextBox (à TextBox l’aide du style) à l’aide de la RelativeSource propriété. Pour plus d’informations sur cet exemple, consultez Guide pratique pour implémenter la validation de liaison.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Remarques

Chaque liaison possède généralement ces quatre composants : un objet cible de liaison, une propriété cible, une source de liaison et un chemin d’accès à la valeur dans la source de liaison à utiliser. Pour plus d’informations sur ces concepts de liaison de données, consultez Vue d’ensemble de la liaison de données.

Utilisez la Path propriété pour spécifier la valeur source à lier à :

• Dans le cas le plus simple, la Path valeur de la propriété est le nom de la propriété de l’objet source à utiliser pour la liaison, par Path=PropertyNameexemple .

• Les sous-propriétés d’une propriété peuvent être spécifiées par une syntaxe similaire à celle utilisée en C#. Par exemple, la clause Path=ShoppingCart.Order définit la liaison sur la sous-propriété Order de l’objet ou de la propriété ShoppingCart.

• Pour établir une liaison à une propriété jointe, placez les parenthèses autour de la propriété jointe. Par exemple, pour établir une liaison à la propriété DockPanel.Dockjointe, la syntaxe est Path=(DockPanel.Dock).

• Les indexeurs d’une propriété peuvent être spécifiés entre crochets en suivant le nom de propriété où l’indexeur est appliqué. Par exemple, la clause Path=ShoppingCart[0] définit la liaison à l’index qui correspond à la façon dont l’indexation interne de votre propriété gère la chaîne littérale « 0 ». Plusieurs indexeurs sont également pris en charge.

• Les indexeurs et les sous-propriétés peuvent être mélangés dans une Path clause ; par exemple, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• Dans les indexeurs, vous pouvez avoir plusieurs paramètres d’indexeur séparés par des virgules (,). Le type de chaque paramètre peut être spécifié entre parenthèses. Par exemple, vous pouvez avoir Path="[(sys:Int32)42,(sys:Int32)24]", où sys est mappé à l’espace System de noms.

• Lorsque la source est un affichage de collection, l’élément actuel peut être spécifié avec une barre oblique (/). Par exemple, la clause Path=/ définit la liaison à l’élément actif dans l’affichage. Lorsque la source est une collection, cette syntaxe spécifie l’élément actuel de la vue de collection par défaut.

• Les noms et barres obliques des propriétés peuvent être combinés pour parcourir les propriétés qui sont des collections. Par exemple, Path=/Offices/ManagerName spécifie l’élément actuel de la collection source, qui contient une Offices propriété qui est également une collection. Son élément actuel est un objet qui contient une ManagerName propriété.

• Si vous le souhaitez, un chemin d’accès de point (.) peut être utilisé pour établir une liaison à la source actuelle. Dans l’exemple,Text="{Binding}"équivaut àText="{Binding Path=.}".

Pour plus d’informations sur la syntaxe de chemin d’accès, consultez La vue d’ensemble des déclarations de liaison ou la syntaxe XAML PropertyPath.

Pour les liaisons XML, consultez la XPath propriété.

Pour établir une liaison à un objet entier, vous n’avez pas besoin de spécifier la Path propriété. Pour plus d’informations, consultez « Spécification du chemin d’accès à la valeur » dans La vue d’ensemble de la liaison de données.