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

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

  • Статья

Предоставляет уникальный идентификатор для элементов разметки. Для XAML универсальная платформа Windows (UWP) этот уникальный идентификатор используется процессами и инструментами локализации 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). Дополнительные сведения см. в разделе "Система управления ресурсами".

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

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

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