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 对象模型中属性的“逐步”路径的字符串。 对于绑定属性路径，标识“step”的字符是点 (.) 。 索引器引用 (包括多个索引器和类型差异) 也受支持。 有关对象专门使用的 Binding 字符串语法的更多详细信息，请参阅 Binding.Path。 用作绑定源的属性不需要是依赖属性。 如果绑定双向更新，则属性源必须是读写的。 另请注意，绑定目标必须是依赖属性。 有关详细信息，请参阅数据绑定概述。

如果在目标模式下将此 PropertyPath 用于情节提要目标的单步路径， PropertyPath 是 类型名称的字符串。propertyName 限定的依赖属性名称字符串。

如果将此 PropertyPath 用于情节提要目标的复杂路径， Path 是一种标记化字符串格式，用于描述 中 PathParameters给定的各种对象的关系。

• 数组中的每个项都以此格式由括在括号中的项的数组索引指定。 例如，若要指定数组中的第一项，字符串标记为 (0)。

• ) 路径中的项 (“步骤”之间的关系由点 (.) 指定。 前导点的属性是路径中的第一步，后面的 属性是第二步， (可以指定两个) 以外的步骤。 链中的最后一步始终表示要进行动画处理的属性。

• 集合属性中的项使用索引器语法进行访问，索引位于方括号 ([ 和 ]) 。 索引器与表示 属性的标记相加。 例如，下面是一个两步路径，第一步中的标记组合指定该属性集合中的第二项： (0)[1].(1) 。 不能对链中的最后一个属性使用索引器;无法对实际集合位置进行动画处理，必须对该对象上的属性进行动画处理。

的路径字符串 PropertyPath 通常通过构造函数建立： PropertyPath(Object) 绑定或单步情节提要目标的签名， PropertyPath(String, Object[]) 多步骤情节提要目标的签名。

Xaml： 在 XAML 中使用 PropertyPath 描述属性引用作为属性值时，指定的字符串首先由类型转换器处理， (PropertyPathConverter) 。 然后，此类型转换器处理字符串，并根据其语法调用构造函数签名之 PropertyPath 一。 通常，通过处理属性值的类型转换器进行间接处理，PropertyPath而不是在 XAML 中使用 ，而不是声明PropertyPath对象元素，然后将特定值应用于 和 PathParameters等Path属性。 有关详细信息，请参阅 PropertyPath XAML 语法。

XAML 文本用法

PropertyPath类型的成员通常不是在直接 XAML 语法中设置的。 请参阅“备注”。