PropertyPath.Path Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Возвращает или задает строку, описывающую путь.

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

Значение свойства

String

Строка, описывающая путь.

Комментарии

Строка, содержащаяся в этом свойстве, имеет три совершенно разных значения в зависимости от того, используется ли PropertyPath он для пути свойства исходного режима для привязки, для пути одношагового свойства целевого режима для целевого объекта раскадровки или сложного пути для целевого объекта раскадровки.

Если это используется PropertyPath в исходном режиме для привязки, это строка, Path представляющая имя свойства, или может быть строкой, описывающей "пошаговое" путь к свойству в объектной модели СРЕДЫ CLR объекта, используемого в качестве источника привязки. Для пути свойства привязки символ, определяющий "шаг" является точкой (.). Также поддерживаются ссылки индексатора (включая несколько индексаторов и различия типов). Дополнительные сведения о синтаксисе строки, используемой Binding объектом, см. в разделе Binding.Path. Свойство, используемое в качестве источника привязки, не должно быть свойством зависимостей. Если привязка обновляется двумя способами, источник свойств должен быть чтением и записью. Кроме того, обратите внимание, что целевой объект привязки должен быть свойством зависимостей. Дополнительные сведения см. в обзоре привязки данных.

Если это используется PropertyPath в целевом режиме для одношагового пути для целевого объекта раскадровки, PropertyPath это строка, которая является типомName. строка имени свойства propertyName с полным именем свойства зависимостей.

Если это используется PropertyPath для сложного пути для целевого объекта раскадровки, Path представляет собой маркеризованный строковый формат, описывающий связи различных объектов, заданных в объекте PathParameters.

• Каждый элемент в массиве указывается в этом формате индексом массива для элемента, заключенного в скобки. Например, чтобы указать первый элемент в массиве, строковый маркер имеет значение (0).

• Связи между элементами ("шаги" в пути) задаются точкой (.). Свойство вперед точки — это первый шаг пути, свойство после второго шага и т. д. (можно указать более двух шагов). Последний шаг в цепочке всегда представляет анимированное свойство.

• Элементы в свойствах коллекции доступны с помощью синтаксиса индексатора с индексатором в квадратных скобках ([ и ]). Индексатор является аддитивным к маркеру, представляющего свойство. Например, ниже приведен двухфакторный путь с сочетанием маркеров на первом шаге, указывающим второй элемент из коллекции этого свойства: (0)[1].(1) Нельзя использовать индексатор для последнего свойства в цепочке; Не удается анимировать фактическое положение коллекции, необходимо анимировать свойство для этого объекта.

Строка пути для объекта PropertyPath обычно устанавливается с помощью конструкторов: PropertyPath(Object) сигнатуры для привязок или одношагового раскадровки, PropertyPath(String, Object[]) подписи для целевых объектов раскадровки с несколькими шагами.

XAML: При использовании PropertyPath ссылки на свойства в XAML в качестве значения атрибута указанная строка сначала обрабатывается преобразователем типов (PropertyPathConverter). Затем этот преобразователь типов обрабатывает строку и на основе его синтаксиса вызывает одну из PropertyPath сигнатур конструктора. Это непрямление через преобразователь типов, обрабатывающий значение атрибута, обычно PropertyPath используется в XAML, а не объявляет PropertyPath элемент объекта, а затем применяет определенные значения к таким атрибутам, как Path и PathParameters. Дополнительные сведения см. в разделе PropertyPath XAML Syntax.

Использование текста XAML

PropertyPath Элементы типа обычно не задаются в прямом синтаксисе XAML. См. примечания.