Partage via


Binding.Path Propriété

Définition

Obtient ou définit le chemin de la propriété de source de liaison.

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

void Path(PropertyPath value);
public PropertyPath Path { get; set; }
var propertyPath = binding.path;
binding.path = propertyPath;
Public Property Path As PropertyPath
<Binding Path="propertyPath"/>

Valeur de propriété

Chemin de propriété de la source de la liaison.

Exemples

Le code XAML suivant montre comment définir le chemin d’accès à l’aide de l’extension de balisage {Binding}. Pour obtenir la liste complète du code, consultez l’exemple de liaison de données XAML.

<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. -->
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

Le code XAML suivant montre comment définir le chemin d’accès à l’aide d’indexeurs entiers et de chaînes. Pour obtenir la liste complète du code, consultez l’exemple de liaison de données XAML.

Notes

Les extensions de composant Visual C++ (C++/CX) ne prennent pas actuellement en charge la liaison d’indexeur. Consultez l’exemple pour obtenir une solution de contournement.

<StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team name:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3].Name}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5" />

  </StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team manager:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3][Gaffer]}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5"/>

  </StackPanel>

</StackPanel>

Remarques

Le chemin d’accès peut être une propriété directe de l’objet source ou des sous-propriétés de cet objet que vous parcourez à l’aide de la syntaxe du chemin de propriété. Pour les sources de données Microsoft .NET, les chemins d’accès peuvent également utiliser une syntaxe d’indexeur pour référencer des éléments spécifiques dans une collection. Pour plus d’informations sur le format du chemin de propriété, consultez Syntaxe du chemin d’accès à la propriété.

Pour définir la source de données comme objet Source , le chemin d’accès doit être défini avec une chaîne vide («  »).

Lorsque vous utilisez l’extension de balisage {Binding}, la valeur Path peut être définie à l’aide de l’argument immédiatement suivant la {Binding partie de l’utilisation de l’extension, vous n’avez pas besoin d’inclure Path=explicitement . Par exemple, {Binding Albums} définit la valeur Path de cette liaison comme un PropertyPath construit à partir de la chaîne « Albums » (aucune autre propriété de liaison n’est définie).

La plupart des utilisations de Path impliquent la définition de sa valeur. Pour les scénarios où vous obtenez la valeur pour examiner les propriétés d’une liaison existante, la valeur PropertyPath.Path contient la chaîne qui représente le chemin d’accès.

Vous ne pouvez pas définir les valeurs de propriété d’un objet Binding une fois que cette liaison a été attachée à un élément cible et à une propriété cible. Si vous tentez cette opération, vous obtiendrez une exception d’exécution.

S’applique à

Voir aussi