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 storyboard 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 booléenne pour remplir l’image clé 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 Description
x :Boolean Pour la prise en charge du CLR, correspond à Boolean. XAML analyse les valeurs pour x :Boolean en tant que non-respect de la casse. Notez que « x :Bool » n’est pas une alternative acceptée.
x :String Pour la prise en charge du CLR, correspond à String. 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 respectant 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 d’une syntaxe de texte de connexion implique une valeur signée 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.

Notez par convention que 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.

Notez les dates et heures (les 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.