PropertyPath.Path Eigenschaft

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

Eigenschaftswert

Die Zeichenfolge, die den Pfad beschreibt.

Hinweise

Die in dieser Eigenschaft enthaltene Zeichenfolge hat drei völlig unterschiedliche Bedeutungen, je nachdem, ob für PropertyPath einen Quellmodus-Eigenschaftspfad für eine Bindung, für einen Einzelschritt-Eigenschaftspfad für ein Storyboardziel oder für einen komplexen Pfad für ein Storyboardziel verwendet wird.

Wenn Dies PropertyPath im Quellmodus für eine Bindung verwendet wird, handelt es sich um eine Zeichenfolge, Path die einen Eigenschaftsnamen darstellt oder eine Zeichenfolge sein kann, die einen "schrittweisen" Pfad zu der Eigenschaft im CLR-Objektmodell des Objekts beschreibt, das als Quelle für eine Bindung verwendet wird. Bei einem Bindungseigenschaftspfad ist das Zeichen, das einen "Schritt" identifiziert, ein Punkt (.). Indexerverweise (einschließlich mehrerer Indexer und Typdifferenzierung) werden ebenfalls unterstützt. Weitere Informationen zur Syntax der Zeichenfolge, die speziell vom Binding Objekt verwendet wird, finden Sie unter Binding.Path. Eine Eigenschaft, die als Bindungsquelle verwendet wird, muss keine Abhängigkeitseigenschaft sein. Wenn die Bindung bidirektionale Aktualisierungen enthält, muss die Eigenschaftsquelle schreibgeschützt sein. Beachten Sie außerdem, dass das Bindungsziel eine Abhängigkeitseigenschaft sein muss. Ausführliche Informationen finden Sie unter Data Binding Overview.

Wenn Dies PropertyPath im Zielmodus für einen einstufigen Pfad für ein Storyboardziel verwendet wird, PropertyPath handelt es sich um eine Zeichenfolge, bei der es sich um einen TypeName handelt.propertyName qualified dependency property name string.

Wenn Dies PropertyPath für einen komplexen Pfad für ein Storyboardziel verwendet wird, Path ist ein tokenisiertes Zeichenfolgenformat, das die Beziehungen der verschiedenen Objekte beschreibt, die in der PathParameters.

• Jedes Element im Array wird in diesem Format durch den Arrayindex für das in Klammern eingeschlossene Element angegeben. Um beispielsweise das erste Element im Array anzugeben, lautet (0)das Zeichenfolgentoken .

• Beziehungen zwischen Elementen ("Schritte" im Pfad) werden durch einen Punkt (.) angegeben. Die Eigenschaft vorwärts des Punkts ist der erste Schritt im Pfad, die Eigenschaft nach dem zweiten Schritt usw. (Sie können Schritte über zwei hinaus angeben). Der letzte Schritt in der Kette stellt immer die animierte Eigenschaft dar.

• Auf Elemente innerhalb von Auflistungseigenschaften wird mit einer Indexersyntax zugegriffen, wobei der Index in eckigen Klammern ([ und ]) enthalten ist. Der Indexer ist zu dem Token additiv, das die Eigenschaft darstellt. Der folgende Pfad ist beispielsweise ein zweistufiger Pfad, wobei die Tokenkombination im ersten Schritt das zweite Element aus der Auflistung dieser Eigenschaft angibt: (0)[1].(1) Sie können keinen Indexer für die letzte Eigenschaft in der Kette verwenden; Sie können die tatsächliche Sammlungsposition nicht animieren, Sie müssen eine Eigenschaft für dieses Objekt animieren.

Die Pfadzeichenfolge für eine PropertyPath wird in der Regel über die Konstruktoren erstellt: die PropertyPath(Object) Signatur für Bindungen oder Ein-Schritt-Storyboardziele, die PropertyPath(String, Object[]) Signatur für Mehrschritt-Storyboardziele.

XAML: Wenn Sie einen PropertyPath Eigenschaftsverweis in XAML als Attributwert beschreiben, wird die von Ihnen angegebene Zeichenfolge zuerst von einem Typkonverter (PropertyPathConverter) behandelt. Dieser Typkonverter verarbeitet dann die Zeichenfolge und ruft basierend auf seiner Syntax eine der PropertyPath Konstruktorsignaturen auf. Diese Dereferenzierung durch den Typkonverter, der einen Attributwert verarbeitet, ist in der Regel die Verwendung PropertyPath in XAML, anstatt ein PropertyPath Objektelement zu deklarieren und dann bestimmte Werte auf Attribute wie Path und PathParameters. Weitere Informationen finden Sie unter PropertyPath XAML-Syntax.

XAML-Textverwendung

Elemente des Typs werden in der PropertyPath Regel nicht in einer direkten XAML-Syntax festgelegt. Siehe Anmerkungen.