PropertyPath.Path Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft die Zeichenfolge ab, die den Pfad beschreibt, oder legt diese fest.

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

String

Die Zeichenfolge, die den Pfad beschreibt.

Hinweise

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

Wenn Sie dies PropertyPath im Quellmodus für eine Bindung verwenden, ist eine Zeichenfolge, Path die einen Eigenschaftsnamen darstellt, oder eine Zeichenfolge, die einen "schrittweisen" Pfad zur Eigenschaft im CLR-Objektmodell des Objekts beschreibt, das als Quelle für eine Bindung verwendet wird. Für einen Bindungseigenschaftenpfad 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 in zwei Richtungen aktualisiert wird, muss die Eigenschaftsquelle Lese-/Schreibzugriff sein. Beachten Sie außerdem, dass das Bindungsziel eine Abhängigkeitseigenschaft sein muss. Weitere Informationen finden Sie unter Übersicht über die Datenbindung.

Wenn Sie dies PropertyPath im Zielmodus für einen Pfad in einem einzelnen Schritt für ein Storyboardziel verwenden, ist eine Zeichenfolge, PropertyPath die ein TypeName ist. eigenschaftName : Qualifizierte Abhängigkeitseigenschaft namenszeichenfolge.

Wenn Sie dies PropertyPath für einen komplexen Pfad für ein Storyboardziel verwenden, Path ist ein tokenisiertes Zeichenfolgenformat, das die Beziehungen der verschiedenen Objekte beschreibt, die in angegeben PathParameterssind.

• 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, ist (0)das Zeichenfolgentoken .

• Beziehungen zwischen Elementen ("Schritte" im Pfad) werden durch einen Punkt (.) angegeben. Die Eigenschaft vor dem Punkt ist der erste Schritt im Pfad, die Eigenschaft nach ist der zweite Schritt usw. (Sie können Schritte über zwei angeben). Der letzte Schritt in der Kette stellt immer die Eigenschaft dar, die animiert wird.

• Auf Elemente innerhalb der Auflistungseigenschaften wird mit einer Indexersyntax zugegriffen, wobei der Index in eckigen Klammern ([ und ]) enthalten ist. Der Indexer ist additiv zum Token, 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 ein PropertyPath wird in der Regel über die Konstruktoren festgelegt: die PropertyPath(Object) Signatur für Bindungen oder Storyboardziele in einem Schritt, die PropertyPath(String, Object[]) Signatur für Storyboardziele mit mehreren Schritten.

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

XAML-Textverwendung

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