Binding.Path 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定到綁定來源屬性的路徑。
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 示範如何利用整數與字串索引器設定路徑。 完整程式碼列表請參閱 XAML 資料綁定範例。
<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資料來源,路徑也可以使用索引器語法來參考集合中的特定項目。 關於屬性路徑格式的詳細資訊,請參見 屬性路徑語法。
若要將資料來源設定為 來源 物件,路徑應以空字串(“”)定義。
使用 {Binding} 標記擴充時,Path 值可以用擴充功能使用部分後面緊接 {Binding 的參數設定,不需要明確包含 Path=。 例如,將 {Binding Albums} 該綁定的 Path 值設為由字串「Albums」構成的 PropertyPath (沒有設定其他 Binding 屬性)。
大多數 Path 的用法都涉及設定其值。 在取得檢視現有綁定屬性的值時, PropertyPath.Path 值包含代表路徑的字串。
在綁定物件綁定到目標元素和目標屬性後,你無法設定 該物件的 屬性值。 如果你嘗試這樣做,會遇到執行時例外。