x:Uid 指令
为标记元素提供一个唯一标识符。 在许多情况下,此唯一标识符由 XAML 本地化进程和工具使用。
XAML 属性用法
<object x:Uid="identifier"... />
XAML 值
值 | 说明 |
---|---|
identifier |
手动创建或自动生成的字符串,x:Uid 使用者解释该字符串时,该字符串在文件中应该是唯一的。 |
备注
在 [MS-XAML] 中,x:Uid
定义为指令。 有关详细信息,请参阅 [MS-XAML] 第 7.3.6 节。
在规定的 XAML 本地化场景中,x:Uid
与 x:Name
是分离的,所以用于本地化的标识符对 x:Name
的编程模型含义没有任何依赖性。 此外,x:Name
受 XAML 名称范围约束;但是,x:Uid
不受任何 XAML 语言定义的唯一性强制概念的约束。 广义上的 XAML 处理器(不属于本地化进程的处理器)不应强制实现 x:Uid
值的唯一性。 从概念上讲,唯一性应由值的建立者来实现。 单一 XAML 源中 x:Uid
值的唯一性预期对于值的使用者来说是合理的,例如专用的全球化进程或工具。 典型的唯一性模型是 x:Uid
值在表示 XAML 的 XML 编码文件中是唯一的。
要求掌握大量特定 XAML 架构知识的工具可以选择仅对真正的可本地化字符串应用 x:Uid
,而不是将其应用于标记中包含文本字符串值的所有情况。
框架可以将属性 UidPropertyAttribute 应用于定义类型,从而将其对象模型中的特定属性指定为 x:Uid
的别名。 如果框架指定特定属性,则对同一对象同时指定 x:Uid
和别名成员是无效操作。 如果同时指定 x:Uid
和别名成员,.NET XAML 服务 API 通常会在这种情况下引发 XamlDuplicateMemberException。
WPF 用法注释
若要详细了解 x:Uid
在 WPF 本地化进程和 XAML 的 BAML 形式中的作用,请参阅 WPF 的全球化或 Uid