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 d'attributs XAML

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

Valeurs XAML

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

Notes

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 discret à partir des x:Name deux 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 namescope XAML ; toutefois, x:Uid n’est régi par aucun concept de langage XAML défini par 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 x:Uid valeurs. Cette responsabilité est conceptuellement sur l’origine des valeurs. L’attente d’unicité des x:Uid valeurs 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 les 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 de s’appliquer x:Uid uniquement aux 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 en x:Uid 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 les deux x:Uid et le membre alias sur le même objet. Si les deux x:Uid et le membre alias sont spécifiés XamlDuplicateMemberException , l’API des services XAML .NET lève généralement pour ce cas.

Notes d’utilisation WPF

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

Voir aussi