PropertyPath.Path Eigenschap

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

Waarde van eigenschap

De tekenreeks die het pad beschrijft.

Opmerkingen

De tekenreeks in deze eigenschap heeft drie totaal verschillende betekenissen, afhankelijk van of een PropertyPath wordt gebruikt voor een eigenschapspad in de bronmodus voor een binding, voor een eigenschapspad in de doelmodus voor een storyboard-doel of voor een complex pad voor een storyboard-doel.

Als u dit PropertyPath gebruikt in de bronmodus voor een binding, Path een tekenreeks die een eigenschapsnaam vertegenwoordigt, of een tekenreeks die een stapsgewijs pad beschrijft naar de eigenschap in het CLR-objectmodel van het object dat wordt gebruikt als bron voor een binding. Voor een bindingseigenschapspad is het teken dat een 'stap' aangeeft een punt (.). Indexeerverwijzingen (inclusief meerdere indexeerfuncties en typescheiding) worden ook ondersteund. Zie voor meer informatie over de syntaxis van de tekenreeks die specifiek door het Binding object Binding.Pathwordt gebruikt. Een eigenschap die als bindingsbron wordt gebruikt, hoeft geen afhankelijkheidseigenschap te zijn. Als de binding in twee richtingen wordt bijgewerkt, moet de eigenschapsbron lezen/schrijven zijn. Houd er ook rekening mee dat het bindingsdoel wel een afhankelijkheidseigenschap moet zijn. Zie Overzicht van gegevensbindingenvoor meer informatie.

Als u dit PropertyPath in de doelmodus gebruikt voor een pad met één stap voor een storyboard-doel, PropertyPath is dit een tekenreeks die een typeName is.eigenschapsreeks met gekwalificeerde eigenschap propertyname propertyname.

Als u dit PropertyPath gebruikt voor een complex pad voor een storyboard-doel, Path is een tokenized tekenreeksindeling die de relaties beschrijft van de verschillende objecten in de PathParameters.

• Elk item in de matrix wordt in deze indeling opgegeven door de matrixindex voor het item tussen haakjes. Als u bijvoorbeeld het eerste item in de matrix wilt opgeven, is (0)het tekenreekstoken.

• Relaties tussen items ('stappen' in het pad) worden opgegeven door een punt (.). De eigenschap voorwaarts van de punt is de eerste stap in het pad, de eigenschap na de tweede stap, enzovoort (u kunt stappen na twee opgeven). De laatste stap in de keten vertegenwoordigt altijd de eigenschap die wordt geanimeerd.

• Items in verzamelingseigenschappen worden geopend met een indexeerfunctiesyntaxis, met de index tussen vierkante haken ([ en ]). De indexeerfunctie is additief aan het token dat de eigenschap vertegenwoordigt. Het volgende is bijvoorbeeld een tweestapspad, waarbij de combinatie van het token in de eerste stap het tweede item opgeeft vanuit de verzameling van die eigenschap: (0)[1].(1) . U kunt geen indexeerfunctie gebruiken voor de laatste eigenschap in de keten; u kunt geen animatie toepassen op de werkelijke positie van de verzameling. U moet een eigenschap in dat object animeren.

De padtekenreeks voor een PropertyPath wordt doorgaans tot stand gebracht via de constructors: de PropertyPath(Object) handtekening voor bindingen of storyboarddoelen met één stap, de PropertyPath(String, Object[]) handtekening voor storyboarddoelen met meerdere stappen.

XAML: Wanneer u een PropertyPath eigenschapsverwijzing in XAML als kenmerkwaarde beschrijft, wordt de tekenreeks die u opgeeft, eerst verwerkt door een typeconversieprogramma (PropertyPathConverter). Dit type conversieprogramma verwerkt vervolgens de tekenreeks en op basis van de syntaxis wordt een van de PropertyPath constructorhandtekeningen aangeroepen. Deze indirectie via het typeconversieprogramma dat een kenmerkwaarde verwerkt, is over het algemeen de manier waarop u in XAML gebruikt PropertyPath , in plaats van een PropertyPath objectelement te declareren en vervolgens specifieke waarden toe te passen op kenmerken zoals Path en PathParameters. Zie PropertyPath XAML-syntaxis voor meer informatie.

XAML-tekstgebruik

Leden van het PropertyPath type worden doorgaans niet ingesteld in een directe XAML-syntaxis. Zie opmerkingen.