PropertyPath.Path 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

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

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

屬性值

String

描述路徑的字串。

備註

這個屬性中包含的字串有三個完全不同的意義，取決於 是 PropertyPath 用於系結的來源模式屬性路徑、腳本目標的目標模式單一步驟屬性路徑，還是針對腳本目標的複雜路徑。

如果在系結的來源模式中使用這個 PropertyPath ， Path 則為代表屬性名稱的字串，或者可以是描述物件 CLR 物件模型中屬性之「逐步執行」路徑的字串，該物件是做為系結來源的物件。 對於系結屬性路徑，識別 「step」 的字元是點 (.) 。 也支援索引子參考 (包括多個索引子，以及類型差異) 。 如需 物件特別使用 Binding 之字串語法的詳細資訊，請參閱 Binding.Path 。 做為系結來源的屬性不需要相依性屬性。 如果系結會雙向更新，屬性來源必須是讀寫。 另請注意，系結目標必須是相依性屬性。 如需詳細資訊，請參閱 資料系結概觀。

如果在腳本目標單一步驟路徑的目標模式中使用此選項 PropertyPath ， PropertyPath 則為 typeName 的字串。propertyName 限定相依性屬性名稱字串。

如果針對腳本目標的複雜路徑使用這個 PropertyPath ，則為標記化字串格式， Path 描述 中 PathParameters 指定之各種物件的關聯性。

• 陣列中的每個專案都是由括弧括住之專案的陣列索引，以這個格式指定。 例如，若要指定陣列中的第一個專案，字串標記是 (0) 。

• 路徑) 中專案 (「步驟」之間的關聯性是由點 (.) 所指定。 點向前的屬性是路徑中的第一個步驟、之後的屬性是第二個步驟，依此類推， (您可以指定兩個) 以外的步驟。 鏈結中的最後一個步驟一律代表正在產生動畫效果的屬性。

• 集合屬性內的專案是使用索引子語法來存取，而方括弧內的索引 ([ 和 ]) 。 索引子會加總至代表 屬性的標記。 例如，下列是雙步驟路徑，在第一個步驟中指定該屬性集合內第二個專案的標記組合： (0)[1].(1) 。 您無法在鏈結的最後一個屬性上使用索引子;您無法以動畫顯示實際集合位置，您必須在該物件上建立屬性的動畫效果。

的路徑字串 PropertyPath 通常是透過建構函式所建立： PropertyPath(Object) 系結或單一步驟分鏡腳本目標的簽章、 PropertyPath(String, Object[]) 多步驟分鏡腳本目標的簽章。

XAML： 當您使用 PropertyPath 來描述 XAML 中的屬性參考時，您指定的字串會先由類型轉換器處理 (PropertyPathConverter) 。 然後，此類型轉換器會處理字串，並根據其語法呼叫其中 PropertyPath 一個建構函式簽章。 透過處理屬性值的類型轉換子，這種間接取值通常是您在 XAML 中使用的方式 PropertyPath ，而不是宣告 PropertyPath 物件專案，然後將特定值套用至 和 等 Path PathParameters 屬性。 如需詳細資訊，請參閱 PropertyPath XAML 語法。

XAML 文字使用方式

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