Partager via


Types de données intrinsèques XAML

XAML pour Windows Runtime fournit une prise en charge au niveau du langage pour plusieurs types de données fréquemment utilisés dans le Common Language Runtime (CLR) et dans d’autres langages de programmation tels que C++.

L’endroit le plus courant où vous verrez les utilisations de type de données intrinsèques XAML est le moment où les ressources sont définies dans un dictionnaire de ressources XAML. Vous pouvez définir des constantes là-bas, par exemple des nombres que vous utilisez pour plusieurs valeurs. Vous pouvez également utiliser une animation scénarisée qui s’anime à l’aide d’une chaîne ou d’une valeur booléenne, et vous aurez ensuite besoin d’un élément d’objet XAML représentant la chaîne ou la valeur booléenne pour remplir le keyframe de votre définition ObjectAnimationUsingKeyFrames. Les modèles XAML par défaut Windows Runtime utilisent ces deux techniques.

XAML pour Windows Runtime fournit une prise en charge au niveau du langage pour ces types.

Primitive XAML Descriptif
x :Boolean Pour la prise en charge du CLR, correspond à Boolean. XAML interprète les valeurs pour x:Boolean en tant qu'insensible à la casse. Notez que « x :Bool » n’est pas une alternative acceptée.
x :String Pour la prise en charge du CLR, cela correspond au type de données String (chaîne). L’encodage de la chaîne est défini par défaut sur l’encodage XML environnant.
x :Double Pour la prise en charge du CLR, correspond à Double. En plus des valeurs numériques, la syntaxe de texte pour x :Double autorise le jeton « NaN », c’est-à-dire la façon dont « Auto » pour le comportement de disposition peut être stocké en tant que valeur de ressource. Les jetons sont traités comme sensibles à la casse. Vous pouvez utiliser la notation scientifique, par exemple « 1+E06 » pour 1,000,000.
x :Int32 Pour la prise en charge du CLR, correspond à Int32. x :Int32 est traité comme signé, et vous pouvez inclure le symbole moins (« -« ) pour un entier négatif. En XAML, l'absence de signe dans la syntaxe textuelle implique une valeur positive.

Ces primitives de langage XAML sont généralement les seuls cas dans lesquels vous définissez un élément d’objet qui utilise le préfixe x : dans votre code XAML. Toutes les autres fonctionnalités de langage XAML sont généralement utilisées sous forme d’attribut ou comme extension de balisage.

Note

Par convention, les primitives de langage pour XAML et tous les autres éléments de langage XAML sont affichées avec le préfixe « x : ». C’est ainsi que les éléments de langage XAML sont généralement utilisés dans le balisage réel. Cette convention est suivie dans la documentation relative au code XAML et dans la spécification XAML.

Autres primitives XAML

La spécification XAML 2009 note d’autres primitives au niveau du langage XAML telles que x :Uri et x :Single. À moins d’être répertoriés dans le tableau de cette rubrique, d’autres primitives de langage XAML définies par d’autres vocabulaires XAML ou par la spécification XAML 2009 ne sont actuellement pas prises en charge en XAML pour Windows Runtime.

Note

Les dates et heures (propriétés qui utilisent DateTime ou DateTimeOffset, TimeSpan ou System.TimeSpan) ne sont pas définies avec une primitive XAML. Ces propriétés ne sont généralement pas paramétrables en XAML du tout, car il n’existe aucun comportement de conversion de chaîne par défaut dans l’analyseur XAML Windows Runtime pour les dates et les heures. Pour les valeurs d’initialisation de toutes les propriétés de date et d’heure, vous devez utiliser le code-behind qui s’exécute lorsqu’une page ou un élément se charge.