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

Предоставляет уникальный идентификатор для элементов разметки. Для Universal Windows Platform (UWP) XAML этот уникальный идентификатор используется процессами и средствами локализации XAML, такими как использование ресурсов из .resw-файла ресурсов.

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

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

Значения XAML

Срок	Description
stringID	Строка, которая однозначно идентифицирует элемент XAML в приложении и становится частью пути к ресурсу в файле ресурсов. См. примечания.

Замечания

Используйте x:Uid для идентификации элемента объекта в XAML. Обычно этот элемент объекта является экземпляром класса элемента управления или другого элемента, отображаемого в пользовательском интерфейсе. Связь между строкой, используемой в x:Uid и строками, используемыми в файле ресурсов, заключается в том, что строки файла ресурсов являются x:Uid , за которым следует точка (.), а затем по имени определенного свойства локализованного элемента. Рассмотрим этот пример:

<Button x:Uid="GoButton" Content="Go"/>

Чтобы указать содержимое для замены отображаемого текста Go, необходимо указать новый ресурс, поступающий из файла ресурса. Файл ресурса должен содержать запись для ресурса с именем GoButton.Content. Содержимое в этом случае является определенным свойством, унаследованным классом Button . Вы также можете указать локализованные значения для других свойств этой кнопки, например можно указать значение на основе ресурсов для GoButton.FlowDirection. Дополнительные сведения об использовании файлов x:Uid и ресурсов см. в разделе "Локализация строк" в манифесте пакета пользовательского интерфейса и приложения.

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

x:Uid дискретен из x:Name как из-за указанного сценария локализации XAML, так и поэтому идентификаторы, используемые для локализации, не имеют зависимостей от последствий модели программирования x:Name. Кроме того, x:Name регулируется понятием области имен XAML, а уникальность x:Uid управляется системой индекса ресурсов пакета (PRI). Дополнительные сведения см. в статье "Управление ресурсами с помощью MRT Core и системы управления ресурсами".

В XAML среды выполнения Windows действуют несколько иные правила уникальности x:Uid, чем в предыдущих технологиях, использующих XAML. Для XAML среды выполнения Windows допустимо использовать одно и то же значение идентификатора x:Uid в качестве директивы для нескольких элементов XAML. Однако каждый такой элемент должен использовать одинаковую логику обработки при решении вопроса с ресурсами в файле ресурсов. Кроме того, все файлы XAML в проекте используют одну область ресурсов для разрешения x:Uid, и нет концепции областей x:Uid, которые бы соответствовали отдельным файлам XAML.

В некоторых случаях вы будете использовать путь к ресурсу, а не встроенные функции системы индекса ресурсов пакета (PRI). Любая строка, используемая в качестве значения x:Uid , определяет путь к ресурсу, который начинается с ms-resource:///Resources/ и включает строку x:Uid . Путь завершается именами свойств, указанных в файле ресурсов или иными целевыми объектами.

Не помещайте x:Uid в элементы свойств, которые не разрешены в XAML среды выполнения Windows.