Partager via


PropertyPath.Path Propriété

Définition

Obtient ou définit la chaîne qui décrit le chemin d'accès.

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’un PropertyPath est utilisé pour un chemin de propriété en mode source pour une liaison, pour un chemin de propriété à étape unique en mode cible pour une cible de storyboard ou pour un chemin complexe pour une cible de storyboard.

Si vous l’utilisez PropertyPath 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 pour une liaison. Pour un chemin d’accès à une propriété de liaison, le caractère qui identifie une « étape » est un point (.). Les références d’indexeurs (y compris plusieurs indexeurs et la différenciation de type) sont également prises en charge. Pour plus d’informations sur la syntaxe de la chaîne utilisée spécifiquement 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 l’utilisez PropertyPath en mode cible pour un chemin d’accès à étape unique pour une cible de storyboard, PropertyPath est une chaîne qui est un typeName. propertyName chaîne de nom de propriété de dépendance qualifiée.

Si vous l’utilisez PropertyPath pour un chemin d’accès complexe pour une cible de table de montage séquentiel, Path est un format de chaîne avec jetons 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 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é en avant du point est la première étape du chemin, la propriété après est 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 des 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, le chemin d’accès suivant est 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 d’indexeur sur la dernière propriété de la chaîne ; vous ne pouvez pas animer la position réelle de la collection. 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 PropertyPath des signatures de 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, au lieu 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. Consultez la section Notes.

S’applique à