Поделиться через


Директива x:Uid

Предоставляет уникальный идентификатор для элементов разметки. Во многих сценариях этот уникальный идентификатор используется процессами и инструментами локализации XAML.

Использование атрибута XAML

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

Значения XAML

Ценность Описание
identifier Созданная вручную или автогенерированная строка, которая должна быть уникальной в файле при интерпретации x:Uid потребителем.

Замечания

В [MS-XAML]x:Uid определяется как директива. Дополнительные сведения см. в разделе [MS-XAML] 7.3.6.

x:Uid дискретно из x:Name как из-за указанного сценария локализации XAML, так и для идентификаторов, используемых для локализации, не зависят от последствий модели программирования x:Name. Кроме того, x:Name управляется областью имен XAML; однако x:Uid не регулируется каким-либо языком XAML, определенным понятием применения уникальности. Процессоры XAML в широком смысле (процессоры, которые не являются частью процесса локализации), не должны применять уникальность значений x:Uid. Эта ответственность концептуально связана с источником значений. Ожидание уникальности значений x:Uid в одном источнике XAML разумно для потребителей значений, таких как выделенные процессы глобализации или инструменты. Типичная модель уникальности заключается в том, что x:Uid значения уникальны в XML-кодированном файле, представляющего XAML.

Средства, имеющие значительные знания о конкретной схеме XAML, могут применять x:Uid только для истинных локализуемых строк, а не для всех случаев, когда текстовое строковое значение встречается в разметке.

Платформы могут указать определенное свойство в объектной модели, чтобы быть псевдонимом для x:Uid, применяя атрибут UidPropertyAttribute к определяемого типа. Если платформа задает определенное свойство, недопустимо указывать оба x:Uid и псевдоним члена одного объекта. Если заданы оба x:Uid и псевдонимный член, API служб XAML .NET обычно вызывает XamlDuplicateMemberException для этого случая.

Заметки об использовании WPF

Дополнительные сведения о роли x:Uid в процессе локализации WPF и в форме BAML XAML см. в глобализации для WPF или Uid

См. также