Attribut x:Class

Configure la compilation XAML afin de joindre des classes partielles entre le balisage et le code-behind. La classe partielle du code est définie dans un fichier de code distinct et la classe partielle de balisage est créée par la génération du code lors de la compilation XAML.

Utilisation des attributs XAML

<object x:Class="namespace.classname"...>
  ...
</object>

Valeurs XAML

Terme	Description
espace de noms	facultatif. Spécifie un espace de noms qui contient la classe partielle identifiée par classname. Si namespace est spécifié, un point (.) sépare namespace et classname. Si namespace est omis, classname est considéré comme n’ayant pas d’espace de noms.
classname	Obligatoire. Spécifie le nom de la classe partielle qui connecte le code XAML chargé et votre code-behind pour ce code XAML.

Remarques

Il est possible de déclarer x:Class en tant qu’attribut pour un élément qui est la racine d’une arborescence d’objets/d’un fichier XAML et qui est compilé par des actions de génération, ou pour la racine de la classe Application dans la définition d’application d’une application compilée. La déclaration de x:Class sur un élément autre qu’un nœud racine, et dans toutes les circonstances pour un fichier XAML qui n’est pas compilé avec l’action de génération Page, engendre une erreur au moment de la compilation.

La classe utilisée en tant que x:Class ne peut pas être une classe imbriquée.

La valeur de l’attribut x:Class doit être une chaîne qui spécifie le nom qualifié complet d’une classe. Vous pouvez omettre les informations relatives à l’espace de noms tant qu’il s’agit de la manière dont le code-behind est également structuré (votre définition de classe démarre au niveau de la classe). Le fichier code-behind d’une définition de page ou d’application doit se trouver dans un fichier de code inclus dans le cadre du projet. La classe code-behind doit être publique. La classe code-behind doit être partielle.

Règle du langage CLR

Bien que votre fichier code-behind puisse être un fichier C++, il existe certaines conventions qui suivent quand même la forme du langage CLR, afin qu’il n’y ait aucune différence dans la syntaxe XAML. En particulier, le séparateur entre l’espace de noms et les composants de nom de classe d’une valeur x:Class est toujours un point (« . »), même si le séparateur entre l’espace de noms et le nom de classe dans le fichier de code C++ associé au XAML est « :: ». Si vous déclarez des espaces de noms imbriqués en C++, le séparateur entre les chaînes d’espaces de noms imbriquées successives doit être également « . » plutôt que « :: » quand vous spécifiez la partie namespace de la valeur x:Class.