Binding.Path 属性

定义

命名空间:

Windows.UI.Xaml.Data

获取或设置绑定源属性的路径。

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"/>

属性值

PropertyPath

绑定源的属性路径。

示例

以下 XAML 演示如何使用 {Binding} 标记扩展设置路径。 有关完整的代码列表，请参阅 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>

以下 XAML 演示如何使用整数和字符串索引器设置 Path。 有关完整的代码列表，请参阅 XAML 数据绑定示例。

注意

(C++/CX) 的 Visual C++ 组件扩展当前不支持索引器绑定。 有关解决方法，请参阅示例。

<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>

注解

路径可以是源对象的直接属性，也可以是使用该属性路径语法遍历到的对象的子属性。 对于 Microsoft .NET 数据源，路径还可以使用索引器语法来引用集合中的特定项。 有关属性路径格式的详细信息，请参阅 属性路径语法。

若要将数据源设置为 Source 对象，应使用空字符串 (“”) 定义路径。

使用 {Binding} 标记扩展时，可以使用紧跟在扩展用法部分后面的 {Binding 参数设置 Path 值，无需显式包含 Path=。 例如， {Binding Albums} 将该绑定的 Path 值设置为从字符串“Albums”构造的 PropertyPath ， () 没有设置其他 Binding 属性。

Path 的大多数用法都涉及设置其值。 对于要获取值以检查现有绑定的属性的方案， PropertyPath.Path 值包含表示路径的字符串。

在绑定已附加到目标元素和目标属性之后，无法设置 Binding 对象的属性值。 如果尝试此操作，将收到运行时异常。

另请参阅

• PropertyPath
• XAML 数据绑定示例
• 深入了解数据绑定