PropertyPath.Path Eigenschaft

Definition

Ruft die Zeichenfolge ab, die den Pfad beschreibt, oder legt diese fest.Gets or sets the string that describes the 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

Eigenschaftswert

String

Die Zeichenfolge, die den Pfad beschreibt.The string that describes the path.

Hinweise

Die in dieser Eigenschaft enthaltene Zeichenfolge hat drei völlig unterschiedliche Bedeutungen, abhängig davon, ob eine PropertyPath für einen Eigenschafts Pfad im Quellmodus für eine Bindung verwendet wird, für einen Einzelschritt-Eigenschafts Pfad für einen Ziel Modus eines Storyboard-Ziels oder für einen komplexen Pfad für ein Storyboard-Ziel.The string contained in this property has three completely different meanings depending on whether a PropertyPath is being used for a source-mode property path for a binding, for a target-mode single-step property path for a storyboard target, or for a complex path for a storyboard target.

Wenn diese PropertyPath im Quell Modus für eine Bindung verwendet wird, Path ist eine Zeichenfolge, die einen Eigenschaftsnamen darstellt, oder eine Zeichenfolge, die einen Schritt-für-Schritt-Pfad zur-Eigenschaft im CLRCLR Objektmodell des Objekts beschreibt, das als Quelle für eine Bindung verwendet wird.If using this PropertyPath in source mode for a binding, Path is a string representing a property name, or can be a string that describes a "step-through" path to the property in the CLRCLR object model of the object that is being used as the source for a binding. Bei einem Bindungs Eigenschafts Pfad ist das Zeichen, das einen "Schritt" bezeichnet, ein Punkt (.).For a binding property path, the character that identifies a "step" is a dot (.). Indexerverweise (einschließlich mehrerer Indexer und Typdifferenzierung) werden ebenfalls unterstützt.Indexer references (including multiple indexers, and type differentiation) are also supported. Weitere Informationen zur Syntax der Zeichenfolge, die speziell vom-Objekt verwendet Binding wird, finden Sie unter Binding.Path .For more details on the syntax of the string as specifically used by the Binding object, see Binding.Path. Eine Eigenschaft, die als Bindungs Quelle verwendet wird, muss keine Abhängigkeits Eigenschaft sein.A property used as a binding source need not be a dependency property. Wenn die Bindung bidirektional aktualisiert wird, muss die Eigenschaften Quelle mit Lese-/Schreibzugriff erfolgen.If the binding updates two-way, the property source must be read-write. Beachten Sie außerdem, dass das Bindungs Ziel eine Abhängigkeits Eigenschaft sein muss.Also note that the binding target does have to be a dependency property. Weitere Informationen finden Sie unter Übersicht über die Datenbindung.For details, see Data Binding Overview.

Wenn diese PropertyPath im Zielmodus für einen Einzelschritt Pfad für ein Storyboard-Ziel verwendet wird, PropertyPath ist eine Zeichenfolge, die ein Typnameist.* PropertyName* qualifizierte Zeichenfolge für Abhängigkeits Eigenschaftsnamen.If using this PropertyPath in target mode for a single-step path for a storyboard target, PropertyPath is a string that is a typeName.propertyName qualified dependency property name string.

Wenn diese PropertyPath für einen komplexen Pfad für ein Storyboard-Ziel verwendet wird, Path ist ein Zeichen folgen Format mit Token, das die Beziehungen der verschiedenen in angegebenen Objekte beschreibt PathParameters .If using this PropertyPath for a complex path for a storyboard target, Path is a tokenized string format that describes the relationships of the various objects given in the PathParameters.

  • Jedes Element im Array wird in diesem Format durch den Array Index für das in Klammern eingeschlossene Element angegeben.Each item in the array is specified in this format by the array index for the item enclosed in parentheses. Um z. b. das erste Element im Array anzugeben, ist das Zeichen folgen Token (0) .For example, to specify the first item in the array, the string token is (0).

  • Beziehungen zwischen Elementen ("Steps" im Pfad) werden durch einen Punkt (.) angegeben.Relationships between items ("steps" in the path) are specified by a dot (.). 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 hinaus angeben).The property forward of the dot is the first step in the path, the property after is the second step, and so on (you can specify steps beyond two). Der letzte Schritt in der Kette steht immer für die zu animierende Eigenschaft.The last step in the chain always represents the property being animated.

  • Auf Elemente innerhalb von Auflistungs Eigenschaften wird mit einer Indexer-Syntax zugegriffen, wobei der Index in eckigen Klammern ([und]) liegt.Items within collection properties are accessed with an indexer syntax, with the index within square brackets ([ and ]). Der Indexer ist für das Token, das die Eigenschaft darstellt, Additiv.The indexer is additive to the token representing the property. Das folgende Beispiel zeigt einen zweistufigen Pfad mit der Tokenkombination im ersten Schritt, der das zweite Element in der-Auflistung dieser Eigenschaft angibt: (0)[1].(1) .For example, the following is a two-step path, with the token combination in the first step specifying the second item from within the collection of that property: (0)[1].(1) . Ein Indexer kann nicht für die letzte Eigenschaft in der Kette verwendet werden. die tatsächliche Auflistungs Position kann nicht animiert werden. Sie müssen eine Eigenschaft für dieses Objekt animieren.You cannot use an indexer on the last property in the chain; you cannot animate the actual collection position, you must animate a property on that object.

Die Pfad Zeichenfolge für eine PropertyPath wird in der Regel über die Konstruktoren festgelegt: die PropertyPath(Object) Signatur für Bindungen oder Storyboard-Ziele mit einem einzelnen Schritt, die PropertyPath(String, Object[]) Signatur für mehrstufige Storyboard-Ziele.The path string for a PropertyPath is typically established through the constructors: the PropertyPath(Object) signature for bindings or single-step storyboard targets, the PropertyPath(String, Object[]) signature for multi-step storyboard targets.

XAML: Wenn Sie einen PropertyPath Eigenschafts Verweis in XAMLXAML als Attribut Wert beschreiben, wird die von Ihnen angegebene Zeichenfolge zuerst von einem Typkonverter ( PropertyPathConverter ) behandelt.XAML: When you use a PropertyPath to describe a property reference in XAMLXAML, as an attribute value, the string that you specify is first handled by a type converter (PropertyPathConverter). Dieser Typkonverter verarbeitet dann die Zeichenfolge und ruft basierend auf der Syntax eine der PropertyPath Konstruktorsignaturen auf.This type converter then processes the string and based on its syntax will call one of the PropertyPath constructor signatures. Diese Dereferenzierung durch den Typkonverter, der einen Attribut Wert verarbeitet, ist im Allgemeinen die Verwendung PropertyPath XAMLXAML von in, anstatt ein PropertyPath -Objekt Element zu deklarieren und dann bestimmte Werte auf Attribute wie Path und anzuwenden PathParameters .This indirection through the type converter handling an attribute value is generally how you use PropertyPath in XAMLXAML, rather than declaring a PropertyPath object element and then applying specific values to attributes such as Path and PathParameters. Weitere Informationen finden Sie unter PropertyPath-XAML-Syntax.For more information, see PropertyPath XAML Syntax.

Verwendung von XAML-TextXAML Text Usage

Member des PropertyPath Typs werden in der Regel nicht in einer direkten XAMLXAML Syntax festgelegt.Members of the PropertyPath type are not typically set in a direct XAMLXAML syntax. Siehe Hinweise.See Remarks.

Gilt für: