PropertyPath.Path Właściwość

Definicja

Pobiera lub ustawia ciąg opisujący ścieżkę.

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

Wartość właściwości

Ciąg opisujący ścieżkę.

Uwagi

Ciąg zawarty w tej właściwości ma trzy zupełnie różne znaczenia w zależności od tego, czy PropertyPath element jest używany do ścieżki właściwości trybu źródłowego dla powiązania, dla ścieżki właściwości jednoetapowej trybu docelowego dla obiektu docelowego scenorysu, czy dla złożonej ścieżki docelowej scenorysu.

Jeśli jest to PropertyPath używane w trybie źródłowym dla powiązania, Path jest ciągiem reprezentującym nazwę właściwości lub może być ciągiem opisujący ścieżkę "krok po kroku" do właściwości w modelu obiektów CLR obiektu, który jest używany jako źródło powiązania. W przypadku ścieżki właściwości powiązania znak identyfikujący "krok" to kropka (.). Obsługiwane są również odwołania indeksatora (w tym wiele indeksatorów i różnicowanie typów). Aby uzyskać więcej informacji na temat składni ciągu jako specjalnie używanego przez Binding obiekt, zobacz Binding.Path. Właściwość używana jako źródło powiązania nie musi być właściwością zależności. Jeśli powiązanie aktualizuje dwukierunkowo, źródło właściwości musi być odczyt-zapis. Należy również pamiętać, że element docelowy powiązania musi być właściwością zależności. Aby uzyskać szczegółowe informacje, zobacz Omówienie powiązania danych.

Jeśli jest to PropertyPath używane w trybie docelowym dla ścieżki jednoetapowej dla obiektu docelowego scenorysu, PropertyPath jest ciągiem typeName. propertyName kwalifikowany ciąg nazwy właściwości zależności.

W przypadku używania tej PropertyPath ścieżki dla obiektu docelowego Path scenorysu jest tokenizowanym formatem ciągu opisującego relacje różnych obiektów podanych w obiekcie PathParameters.

  • Każdy element w tablicy jest określony w tym formacie przez indeks tablicy dla elementu ujętego w nawiasy. Aby na przykład określić pierwszy element w tablicy, token ciągu to (0).

  • Relacje między elementami ("kroki" w ścieżce) są określane kropką (.). Właściwość do przodu kropki jest pierwszym krokiem w ścieżce, właściwość po jest drugim krokiem i tak dalej (można określić kroki wykraczające poza dwa). Ostatni krok w łańcuchu zawsze reprezentuje właściwość animowaną.

  • Elementy we właściwościach kolekcji są dostępne za pomocą składni indeksatora z indeksatorem w nawiasach kwadratowych ([ i ]). Indeksator jest dodany do tokenu reprezentującego właściwość . Na przykład poniżej znajduje się ścieżka dwuetapowa z kombinacją tokenu w pierwszym kroku określającym drugi element z kolekcji tej właściwości: (0)[1].(1) . Nie można użyć indeksatora w ostatniej właściwości w łańcuchu; Nie można animować rzeczywistej pozycji kolekcji. Należy animować właściwości na tym obiekcie.

Ciąg ścieżki dla elementu PropertyPath jest zwykle ustanawiany za pomocą konstruktorów: PropertyPath(Object) podpis powiązań lub obiektów docelowych scenorysu jednoetapowego, PropertyPath(String, Object[]) podpis dla celów scenorysu wieloetapowego.

XAML: W przypadku użycia elementu do PropertyPath opisania odwołania do właściwości w języku XAML jako wartości atrybutu określony ciąg jest najpierw obsługiwany przez konwerter typów (PropertyPathConverter). Ten konwerter typów następnie przetwarza ciąg i na podstawie jego składni wywoła jeden z PropertyPath podpisów konstruktora. Ten pośredni za pośrednictwem konwertera typów obsługującego wartość atrybutu jest ogólnie używany PropertyPath w języku XAML, zamiast deklarować PropertyPath element obiektu, a następnie stosować określone wartości do atrybutów, takich jak Path i PathParameters. Aby uzyskać więcej informacji, zobacz PropertyPath XAML Składnia.

Użycie tekstu w języku XAML

PropertyPath Elementy członkowskie typu nie są zwykle ustawiane w bezpośredniej składni XAML. Zobacz uwagi.

Dotyczy