Binding.Path 属性

定义

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

适用于 UWP 的等效 WinUI 2 API:Windows 应用 SDK WinUI 的 Microsoft.UI.Xaml.Data.Binding.Path (,请参阅 Windows 应用 SDK命名空间) 。

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 演示如何使用整数和字符串索引器设置路径。 有关完整的代码列表,请参阅 XAML 数据绑定示例

备注

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

<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 数据源,路径还可以使用索引器语法引用集合中的特定项。 有关属性路径格式的详细信息,请参阅 Property-path 语法

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

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

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

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

适用于

另请参阅