PropertyPath.Path Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property Path As StringWartość 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 dla ś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 używasz tego PropertyPath elementu w trybie źródłowym dla powiązania, Path to ciąg reprezentujący 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, która jest używana specjalnie 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 używasz tego PropertyPath w trybie docelowym dla ścieżki jednoetapowej dla obiektu docelowego scenorysu, PropertyPath to ciąg, który jest typeName.propertyName kwalifikowany ciąg nazwy właściwości zależności.
W przypadku używania tej PropertyPath metody dla złożonej ścieżki 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. Na przykład aby określić pierwszy element w tablicy, token ciągu to
(0).Relacje między elementami ("kroki" w ścieżce) są określane przez 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 animowaną właściwość.
Dostęp do elementów we właściwościach kolekcji jest uzyskiwany za pomocą składni indeksatora z indeksem w nawiasach kwadratowych ([ i ]). Indeksator jest dodatkiem 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 tego obiektu.
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 obiektów docelowych scenorysu wieloetapowego.
XAML: Jeśli używasz PropertyPath elementu , aby opisać odwołanie do właściwości w języku XAML, jako wartość atrybutu, określony ciąg jest najpierw obsługiwany przez konwerter typów (PropertyPathConverter). Ten konwerter typów przetwarza następnie ciąg i na podstawie jego składni wywoła jeden z PropertyPath podpisów konstruktora. Ta pośrednia przez konwerter typów obsługujący wartość atrybutu jest zazwyczaj sposobem użycia PropertyPath w języku XAML, a nie deklarowaniem PropertyPath elementu obiektu, a następnie stosowanie określonych wartości do atrybutów, takich jak Path i PathParameters. Aby uzyskać więcej informacji, zobacz PropertyPath XAML Syntax (Składnia XAML propertyPath).
Użycie tekstu XAML
PropertyPath Elementy członkowskie typu nie są zwykle ustawiane w bezpośredniej składni XAML. Zobacz uwagi.
