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

另请参阅