Partager via

x :Uid, directive

  • Article

Fournit un identificateur unique pour les éléments de balisage. Dans de nombreux scénarios, cet identificateur unique est utilisé par les processus et outils de localisation XAML.

Utilisation des attributs XAML

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

Valeurs XAML

Valeur Description
identifier Chaîne créée ou générée manuellement qui doit être unique dans un fichier lorsqu’elle est interprétée par un consommateur x:Uid.

Remarques

Dans [MS-XAML], x:Uid est défini comme une directive. Pour plus d’informations, consultez [MS-XAML] Section 7.3.6.

x:Uid est discrète 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égie par la portée de nom XAML ; toutefois, x:Uid n’est régi par aucun concept défini par le langage XAML de l’application de l’unicité. Les processeurs XAML dans un sens large (les processeurs qui ne font pas partie du processus de localisation) ne sont pas censés appliquer l’unicité des valeurs de x:Uid. Cette responsabilité est conceptuellement sur l’origine des valeurs. L’attente de l’unicité des valeurs de x:Uid au sein d’une seule source XAML est raisonnable pour les consommateurs des valeurs, telles que les processus de globalisation dédiés ou les outils. Le modèle d’unicité classique est que x:Uid valeurs sont uniques dans un fichier encodé XML qui représente XAML.

Les outils qui ont une connaissance significative d’un schéma XAML particulier peuvent choisir d’appliquer x:Uid uniquement pour les chaînes localisables vraies, au lieu de tous les cas où une valeur de chaîne de texte est rencontrée dans le balisage.

Les frameworks peuvent spécifier une propriété particulière dans leur modèle objet pour être un alias pour x:Uid en appliquant l’attribut UidPropertyAttribute au type de définition. Si une infrastructure spécifie une propriété particulière, elle n’est pas valide pour spécifier à la fois x:Uid et le membre alias sur le même objet. Si x:Uid et le membre alias sont spécifiés, l’API des services XAML .NET lève généralement XamlDuplicateMemberException pour ce cas.

Notes d’utilisation WPF

Pour plus d’informations sur le rôle de x:Uid dans le processus de localisation WPF et dans la forme BAML de XAML, consultez Globalization for WPF ou Uid

Voir aussi