Binding.Path 属性

定义

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

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

属性值

绑定源的属性路径。

示例

以下 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 对象的属性值。 如果尝试此操作,将收到运行时异常。

适用于

另请参阅