共用方式為


Binding.Path 屬性

定義

取得或設定繫結程序來源屬性的路徑。

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 報告驗證錯誤訊息。 setter 的值會系結至目前 TextBox (TextBox 使用 屬性) 樣式 (RelativeSource 的錯誤內容。 如需此範例的詳細資訊,請參閱 如何:實作系結驗證

<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 屬性。 如需詳細資訊,請參閱 資料系結概觀中的。

適用於