Binding.Path 屬性

定義

命名空間:

System.Windows.Data

組件:

PresentationFramework.dll

取得或設定到綁定來源屬性的路徑。

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

public System.Windows.PropertyPath Path { get; set; }

member this.Path : System.Windows.PropertyPath with get, set

Public Property Path As PropertyPath

屬性值

PropertyPath

通往束縛源頭的路徑。 預設值為 null。

範例

以下範例展示了一個樣式觸發器，該觸發器會產生 ToolTip 一個並報告驗證錯誤訊息。 設定器的值會利用屬性RelativeSource綁定當前（使用TextBox該樣式）的TextBox錯誤內容。 欲了解更多此範例資訊，請參閱 《如何實作綁定驗證》。

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

備註

每個綁定通常包含這四個組成部分：綁定目標物件、目標屬性、綁定來源，以及通往綁定來源值的路徑。 欲了解更多關於這些資料綁定概念的資訊，請參閱 資料綁定概述。

使用屬性 Path 指定你想綁定的來源值：

• 在最簡單的情況下， Path 屬性值是用於綁定的來源物件屬性名稱，例如 Path=PropertyName。

• 屬性的子屬性可以用類似 C# 的語法來指定。 例如，子句將Path=ShoppingCart.Order綁定設定為物件或屬性ShoppingCart的子屬性Order。

• 要綁定附帶財產，請在附帶財產周圍加上括號。 例如，綁定附加屬性 DockPanel.Dock時，語法為 Path=(DockPanel.Dock)。

• 屬性的索引器可以在該索引器應用的屬性名稱後方括號內指定。 例如，子句將 Path=ShoppingCart[0] 綁定設定為對應於你屬性內部索引處理字串「0」的索引。 同時也支援多個索引器。

• 索引器與子性質可以混入子 Path 句中;例如， Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• 在索引器內部，你可以有多個索引器參數，並用逗號（，）分隔。 每個參數的類型可以用括號表示。 例如，你可以有 Path="[(sys:Int32)42,(sys:Int32)24]"，其中 sys 映射到 System 命名空間。

• 當來源是集合檢視時，目前項目可以用斜杠（/）來指定。 例如，子句將 Path=/ 綁定設定為視圖中目前的項目。 當來源為集合時，此語法指定預設集合檢視的當前項目。

• 屬性名稱與斜線可以組合起來，以遍歷屬於集合的屬性。 例如， Path=/Offices/ManagerName 指定來源集合的當前項目，該集合包含一個 Offices 同時也是集合的屬性。 目前的項目是一個包含屬性 ManagerName 的物件。

• 可選擇性地使用週期（.）路徑來綁定電流源。 例如， Text="{Binding}" 相當於 Text="{Binding Path=.}"。

關於路徑語法的資訊，請參閱 綁定聲明概述 或 PropertyPath XAML 語法。

關於 XML 綁定，請參見屬性。XPath

要綁定整個物件，你不需要指定屬性。Path 更多資訊請參閱 資料綁定概述中的「指定通往該值的路徑」。