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 報告驗證錯誤訊息。 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 屬性。 如需詳細資訊，請參閱 資料系結概觀中的。