directive x:Uid

Fournit un identificateur unique pour les éléments de balisage. Pour plateforme Windows universelle XAML (UWP), cet identificateur unique est utilisé par les processus et outils de localisation XAML, tels que l’utilisation de ressources à partir d’un fichier de ressources .resw.

Utilisation des attributs XAML

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

Valeurs XAML

Notes

Utilisez x :Uid pour identifier un élément objet dans votre code XAML. En règle générale, cet élément objet est une instance d’une classe de contrôle ou d’un autre élément qui s’affiche dans une interface utilisateur. La relation entre la chaîne que vous utilisez dans x :Uid et les chaînes que vous utilisez dans un fichier de ressources est que les chaînes de fichier de ressources sont les chaînes x :Uid suivies d’un point (.), puis par le nom d’une propriété spécifique de l’élément localisé. Prenons cet exemple :

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

Pour spécifier du contenu pour remplacer le texte d’affichage Go, vous devez spécifier une nouvelle ressource provenant d’un fichier de ressources. Votre fichier de ressources doit contenir une entrée pour la ressource nommée « GoButton.Content ». Le contenu dans ce cas est une propriété spécifique héritée par la classe Button. Vous pouvez également fournir des valeurs localisées pour d’autres propriétés de ce bouton, par exemple, vous pouvez fournir une valeur basée sur des ressources pour « GoButton.FlowDirection ». Pour plus d’informations sur l’utilisation de fichiers x :Uid et de ressources ensemble, consultez Localiser les chaînes dans votre manifeste de package d’interface utilisateur et d’application.

La validité de laquelle les chaînes peuvent être utilisées pour une valeur x :Uid est contrôlée dans un sens pratique par lequel les chaînes sont légales en tant qu’identificateur dans un fichier de ressources et un chemin d’accès aux ressources.

x :Uid est discret à partir de x :Name à la fois en raison du scénario de localisation XAML indiqué, et de sorte que les identificateurs utilisés pour la localisation n’aient aucune dépendance sur les implications du modèle de programmation de x :Name. En outre, x :Name est régi par le concept de portée de nom XAML, tandis que l’unicité pour x :Uid est contrôlée par le système d’index de ressource de package (PRI). Pour plus d’informations, consultez Le système de gestion des ressources.

Le code XAML UWP a des règles quelque peu différentes pour l’unicité x :Uid que les technologies xaml précédentes utilisées. Pour le code XAML UWP, il est légal que la même valeur d’ID x :Uid existe en tant que directive sur plusieurs éléments XAML. Toutefois, chaque élément de ce type doit ensuite partager la même logique de résolution lors de la résolution des ressources dans un fichier de ressources. En outre, tous les fichiers XAML d’un projet partagent une étendue de ressource unique à des fins de résolution x :Uid , il n’existe aucun concept d’étendues x :Uid alignées sur des fichiers XAML individuels.

Dans certains cas, vous allez utiliser un chemin d’accès aux ressources plutôt que des fonctionnalités intégrées du système d’index de ressource de package (PRI). Toute chaîne utilisée en tant que valeur x :Uid définit un chemin d’accès de ressource qui commence par ms-resource :///Resources/ et inclut la chaîne x :Uid . Le chemin d’accès est effectué par les noms des propriétés que vous spécifiez dans un fichier de ressources ou ciblez autrement.

Ne placez pas x :Uid sur les éléments de propriété, qui n’est pas autorisé dans le xaml Windows Runtime.