PropertyPath.Path Propriété

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

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

Valeur de propriété

Chaîne qui décrit le chemin d’accès.

Remarques

La chaîne contenue dans cette propriété a trois significations complètement différentes selon qu’une PropertyPath propriété est utilisée pour un chemin de propriété en mode source pour une liaison, pour un chemin de propriété mono-étape en mode cible pour une cible storyboard, ou pour un chemin complexe pour une cible storyboard.

Si vous utilisez ce PropertyPath paramètre en mode source pour une liaison, Path est une chaîne représentant un nom de propriété ou peut être une chaîne qui décrit un chemin d’accès « pas à pas » à la propriété dans le modèle objet CLR de l’objet utilisé comme source d’une liaison. Pour un chemin de propriété de liaison, le caractère qui identifie une « étape » est un point (.). Les références d’indexeur (y compris plusieurs indexeurs et différenciation de type) sont également prises en charge. Pour plus d’informations sur la syntaxe de la chaîne telle qu’elle est spécifiquement utilisée par l’objet Binding , consultez Binding.Path. Une propriété utilisée comme source de liaison n’a pas besoin d’être une propriété de dépendance. Si la liaison est mise à jour bidirectionnelle, la source de propriété doit être en lecture-écriture. Notez également que la cible de liaison doit être une propriété de dépendance. Pour plus d’informations, consultez Vue d’ensemble de la liaison de données.

Si vous utilisez ce paramètre en mode cible pour un chemin d’accès à une étape unique pour une cible storyboard, PropertyPath il s’agit PropertyPath d’une chaîne qui est un typeName.chaîne de nom de propriété de dépendance qualifiée propertyName.

Si vous l’utilisez PropertyPath pour un chemin complexe pour une cible storyboard, Path est un format de chaîne tokenisé qui décrit les relations des différents objets donnés dans le PathParameters.

• Chaque élément du tableau est spécifié dans ce format par l’index de tableau de l’élément placé entre parenthèses. Par exemple, pour spécifier le premier élément du tableau, le jeton de chaîne est (0).

• Les relations entre les éléments (« étapes » dans le chemin) sont spécifiées par un point (.). La propriété avant du point est la première étape du chemin d’accès, la propriété après la deuxième étape, et ainsi de suite (vous pouvez spécifier des étapes au-delà de deux). La dernière étape de la chaîne représente toujours la propriété animée.

• Les éléments dans les propriétés de collection sont accessibles avec une syntaxe d’indexeur, avec l’index entre crochets ([ et ]). L’indexeur est additif au jeton représentant la propriété. Par exemple, voici un chemin d’accès en deux étapes, avec la combinaison de jetons dans la première étape spécifiant le deuxième élément à partir de la collection de cette propriété : (0)[1].(1) . Vous ne pouvez pas utiliser un indexeur sur la dernière propriété de la chaîne ; vous ne pouvez pas animer la position de collection réelle, vous devez animer une propriété sur cet objet.

La chaîne de chemin d’accès d’un PropertyPath est généralement établie par le biais des constructeurs : la PropertyPath(Object) signature pour les liaisons ou les cibles de storyboard à étape unique, la PropertyPath(String, Object[]) signature pour les cibles de storyboard à plusieurs étapes.

XAML: Lorsque vous utilisez un PropertyPath pour décrire une référence de propriété en XAML, en tant que valeur d’attribut, la chaîne que vous spécifiez est d’abord gérée par un convertisseur de type (PropertyPathConverter). Ce convertisseur de type traite ensuite la chaîne et en fonction de sa syntaxe appelle l’une des signatures du PropertyPath constructeur. Cette indirection par le biais du convertisseur de type qui gère une valeur d’attribut est généralement la façon dont vous utilisez PropertyPath en XAML, plutôt que de déclarer un PropertyPath élément d’objet, puis d’appliquer des valeurs spécifiques à des attributs tels que Path et PathParameters. Pour plus d’informations, consultez Syntaxe XAML PropertyPath.

Utilisation du texte XAML

Les membres du PropertyPath type ne sont généralement pas définis dans une syntaxe XAML directe. Voir les remarques.