語言

PropertyPath.Path 屬性

定義

取得或設定描述路徑的字串。

public:
 property System::String ^ Path { System::String ^ get(); void set(System::String ^ value); };
public string Path { get; set; }
member this.Path : string with get, set
Public Property Path As String

屬性值

描述路徑的繩索。

備註

此屬性中包含的字串根據 a PropertyPath 是用於綁定的來源模式屬性路徑、故事板目標的目標模式單步驟屬性路徑,或是故事板目標的複雜路徑,有三種完全不同的意義。

若以原始碼模式使用綁 PropertyPath 定 Path ,則是代表屬性名稱的字串,或是描述物件 CLR 物件模型中作為綁定來源物件的「步進」路徑的字串。 對於綁定性質路徑,識別「步驟」的字元是一個點(.)。 同時也支援索引器參考(包括多個索引器及型別差異化)。 關於物件特定使用的 Binding 字串語法,請參見 Binding.Path。 用作綁定來源的屬性不一定是依賴性質。 若綁定是雙向更新,屬性來源必須是讀寫。 另外要注意,綁定目標必須是相依屬性。 如需詳細資訊,請參閱 資料系結概觀。

如果在目標模式下用於 PropertyPath 單步路徑 PropertyPath ,則是一串屬於 類型名稱的字串。propertyName 合格的相依關係 property name string。

若用於 PropertyPath 故事板目標的複雜路徑, Path 則為一種標記化字串格式,描述中 PathParameters給出的各種物件之間的關係。

  • 陣列中的每個項目以括號內的陣列索引以此格式指定。 例如,若要指定陣列中的第一個項目,字串標記為 (0)。

  • 項目間的關係(路徑中的「步驟」)以點(.)表示。 點前的性質是路徑的第一步,後面的性質是第二步,依此類推(你可以指定超過兩步的步驟)。 鏈條的最後一步總是代表被動畫化的屬性。

  • 集合屬性中的項目以索引器語法存取,索引以方括號([ 和 ])標示。 索引器是對代表該屬性的標記的加法。 例如,以下為兩步驟路徑,第一步的標記組合指定該屬性集合中的第二個項目: (0)[1].(1) 。 你不能在鏈的最後一個屬性上使用索引器;你無法動畫化實際的集合位置,必須在該物件上動畫化屬性。

a PropertyPath 的路徑串通常透過建構子建立:綁定或單步故事板目標為 PropertyPath(Object) 簽名, PropertyPath(String, Object[]) 多步驟故事板目標為簽名。

XAML: 當你在 XAML 中用 a PropertyPath 來描述屬性參考時,作為屬性值,你指定的字串會先由型別轉換器PropertyPathConverter()處理。 此型別轉換器接著處理字串,並根據語法呼叫其中一個 PropertyPath 建構子簽章。 這種透過型別轉換器處理屬性值的間接方式,通常是 XAML 中使用的PropertyPath做法,而不是先PropertyPath宣告物件元素,然後對屬性如 和 Path套用特定值PathParameters。 欲了解更多資訊,請參閱 PropertyPath XAML 語法。

XAML 文字使用

該 PropertyPath 型別的成員通常不會直接設定在 XAML 語法中。 請參閱備註。

適用於