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 является строкой, которая является typeName. строка имени свойства propertyName с указанием имени зависимостей.

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

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

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

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

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

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

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

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