Binding.Path Propriété

Définition

Obtient ou définit le chemin de la propriété de source de liaison.Gets or sets the path to the binding source property.

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é

PropertyPath

Chemin de la source de liaison.The path to the binding source. La valeur par défaut est null.The default is null.

Exemples

L’exemple suivant montre un déclencheur de style qui crée un ToolTip qui signale un message d’erreur de validation.The following example shows a style trigger that creates a ToolTip that reports a validation error message. La valeur de l’accesseur Set est liée au contenu d’erreur du actuel TextBox ( TextBox à l’aide du style) à l’aide de la RelativeSource propriété.The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Pour plus d’informations sur cet exemple, consultez Comment : implémenter la validation de liaison.For more information on this example, see How to: Implement Binding Validation.

<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

En général, chaque liaison a 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.Each binding typically has these four components: a binding target object, a target property, a binding source, and a path to the value in the binding source to use. Pour plus d’informations sur ces concepts de liaison de données, consultez vue d’ensemblede la liaison de données.For more information about these data binding concepts, see Data Binding Overview.

Utilisez la Path propriété pour spécifier la valeur source que vous souhaitez lier :Use the Path property to specify the source value you want to bind to:

  • Dans le cas le plus simple, la Path valeur de propriété est le nom de la propriété de l’objet source à utiliser pour la liaison, telle que Path=PropertyName .In the simplest case, the Path property value is the name of the property of the source object to use for the binding, such as Path=PropertyName.

  • Les sous-propriétés d’une propriété peuvent être spécifiées à l’aide d’une syntaxe similaire à celle utilisée en C#.Subproperties of a property can be specified by a syntax similar to that used in C#. Par exemple, la clause Path=ShoppingCart.Order définit la liaison à la sous-propriété Order de l’objet ou la propriété ShoppingCart.For instance, the clause Path=ShoppingCart.Order sets the binding to the subproperty Order of the object or property ShoppingCart.

  • Pour lier à une propriété jointe, placez des parenthèses autour de la propriété.To bind to an attached property, place parentheses around the attached property. Par exemple, pour effectuer une liaison à la propriété jointe DockPanel.Dock , la syntaxe est Path=(DockPanel.Dock) .For example, to bind to the attached property DockPanel.Dock, the syntax is Path=(DockPanel.Dock).

  • Des indexeurs de propriété peuvent être spécifiés entre crochets après le nom de la propriété où l’indexeur est appliqué.Indexers of a property can be specified within square brackets following the property name where the indexer is applied. 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 ».For instance, the clause Path=ShoppingCart[0] sets the binding to the index that corresponds to how your property's internal indexing handles the literal string "0". Plusieurs indexeurs sont également pris en charge.Multiple indexers are also supported.

  • Les indexeurs et les sous-propriétés peuvent être combinés en une clause Path ; par exemple, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].Indexers and subproperties can be mixed in a Path clause; for example, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

  • À l’intérieur des indexeurs, vous pouvez avoir plusieurs paramètres d’indexeur séparés par des virgules (,).Inside indexers you can have multiple indexer parameters separated by commas (,). Le type de chaque paramètre peut être spécifié avec des parenthèses.The type of each parameter can be specified with parentheses. Par exemple, vous pouvez avoir Path="[(sys:Int32)42,(sys:Int32)24]", où sys est mappé à l’espace de noms System.For example, you can have Path="[(sys:Int32)42,(sys:Int32)24]", where sys is mapped to the System namespace.

  • Lorsque la source est une vue de collection, l’élément actuel peut être spécifié avec une barre oblique (/).When the source is a collection view, the current item can be specified with a slash (/). Par exemple, la clause Path=/ définit la liaison à l’élément actuel dans la vue.For example, the clause Path=/ sets the binding to the current item in the view. Lorsque la source est une collection, cette syntaxe spécifie l’élément actuel de la vue de collection par défaut.When the source is a collection, this syntax specifies the current item of the default collection view.

  • Les barres obliques et les noms de propriété peuvent être combinés pour parcourir les propriétés qui sont des collections.Property names and slashes can be combined to traverse properties that are collections. Par exemple, Path=/Offices/ManagerName spécifie l’élément actuel de la collection source, qui contient une propriété Offices qui est également une collection.For example, Path=/Offices/ManagerName specifies the current item of the source collection, which contains an Offices property that is also a collection. Son élément actuel est un objet qui contient une propriété ManagerName.Its current item is an object that contains a ManagerName property.

  • Éventuellement, un chemin d’accès ayant la valeur point (.) peut servir à lier à la source actuelle.Optionally, a period (.) path can be used to bind to the current source. Par exemple, Text="{Binding}" équivaut à Text="{Binding Path=.}".For example, Text="{Binding}" is equivalent to Text="{Binding Path=.}".

Pour plus d’informations sur la syntaxe de chemin d’accès, consultez vue d’ensemble des déclarations de liaison ou syntaxe XAML PropertyPath.For information about path syntax, see Binding Declarations Overview or PropertyPath XAML Syntax.

Pour XMLXML les liaisons, consultez la XPath propriété.For XMLXML bindings, see the XPath property.

Pour effectuer une liaison à un objet entier, vous n’avez pas besoin de spécifier la Path propriété.To bind to an entire object, you do not need to specify the Path property. Pour plus d’informations, consultez « Spécification du chemin d’accès à la valeur » dans vue d’ensemblede la liaison de données.For more information, see "Specifying the Path to the Value" in Data Binding Overview.

S’applique à