PropertyPath.Path Egenskap

Definition

Namnområde:

System.Windows

Sammansättning:

PresentationFramework.dll

Hämtar eller anger strängen som beskriver sökvägen.

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

Egenskapsvärde

String

Strängen som beskriver sökvägen.

Kommentarer

Strängen som finns i den här egenskapen har tre helt olika betydelser beroende på om en PropertyPath används för en egenskapssökväg i källläge för en bindning, för en egenskapssökväg i målläge för ett storyboard-mål eller för en komplex sökväg för ett storyboard-mål.

Om du använder detta PropertyPath i källläge för en bindning, Path är en sträng som representerar ett egenskapsnamn, eller kan vara en sträng som beskriver en "stegvis" sökväg till egenskapen i CLR-objektmodellen för objektet som används som källa för en bindning. För en bindningsegenskapssökväg är tecknet som identifierar ett "steg" en punkt (.). Indexerarreferenser (inklusive flera indexerare och typdi differentiering) stöds också. Mer information om syntaxen för strängen som specifikt används av objektet Binding.Pathfinns i Binding . En egenskap som används som bindningskälla behöver inte vara en beroendeegenskap. Om bindningen uppdateras tvåvägs måste egenskapskällan vara skrivskyddad. Observera också att bindningsmålet måste vara en beroendeegenskap. Mer information finns i Översikt över databindning.

Om du använder detta PropertyPath i målläge för en enkelstegssökväg för ett storyboard-mål är PropertyPath en sträng som är ett typeName.propertyName qualified dependency property name string.

Om du använder detta PropertyPath för en komplex sökväg för ett storyboard-mål är Path ett tokeniserat strängformat som beskriver relationerna mellan de olika objekten PathParameterssom anges i .

• Varje objekt i matrisen anges i det här formatet av matrisindexet för objektet som omges av parenteser. Om du till exempel vill ange det första objektet i matrisen är (0)strängtoken .

• Relationer mellan objekt ("steg" i sökvägen) anges av en punkt (.). Egenskapen framåt för punkten är det första steget i sökvägen, egenskapen efter är det andra steget och så vidare (du kan ange steg längre än två). Det sista steget i kedjan representerar alltid egenskapen som animeras.

• Objekt i samlingsegenskaper används med en indexerarsyntax, med indexet inom hakparenteser ([ och ]). Indexeraren är additiv till den token som representerar egenskapen. Följande är till exempel en tvåstegssökväg, där tokenkombinationen i det första steget anger det andra objektet från samlingen för den egenskapen: (0)[1].(1) . Du kan inte använda en indexerare på den sista egenskapen i kedjan. du kan inte animera den faktiska samlingspositionen, du måste animera en egenskap för objektet.

Sökvägssträngen för en PropertyPath upprättas vanligtvis via konstruktorerna: signaturen PropertyPath(Object) för bindningar eller storyboardmål i ett enda steg, signaturen PropertyPath(String, Object[]) för storyboardmål i flera steg.

XAML: När du använder en PropertyPath för att beskriva en egenskapsreferens i XAML, som ett attributvärde, hanteras först strängen som du anger av en typkonverterare (PropertyPathConverter). Den här typkonverteraren bearbetar sedan strängen och baserat på dess syntax anropas en av PropertyPath konstruktorsignaturerna. Den här indirekta användningen via typkonverteraren som hanterar ett attributvärde är vanligtvis hur du använder PropertyPath i XAML, i stället för att deklarera ett PropertyPath objektelement och sedan tillämpa specifika värden på attribut som Path och PathParameters. Mer information finns i PropertyPath XAML-syntax.

XAML-textanvändning

Medlemmar av typen PropertyPath anges vanligtvis inte i en direkt XAML-syntax. Se Kommentarer.