x:Uid 指令

为标记元素提供一个唯一标识符。 在许多情况下,此唯一标识符由 XAML 本地化进程和工具使用。

XAML 属性用法

<object x:Uid="identifier"... />

XAML 值

说明
identifier 手动创建或自动生成的字符串,x:Uid 使用者解释该字符串时,该字符串在文件中应该是唯一的。

备注

在 [MS-XAML] 中,x:Uid 定义为指令。 有关详细信息,请参阅 [MS-XAML] 第 7.3.6 节

在规定的 XAML 本地化场景中,x:Uidx: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

另请参阅