x:Class, attribut
Mise à jour : novembre 2007
Configure la compilation XAML pour joindre des classes partielles entre la balise et le code-behind. La classe partielle du code est définie dans un fichier de code séparé en langage CLS (Common Language Specification), tandis que la classe partielle du balisage est créée par la génération de code lors de la compilation XAML.
Utilisation des attributs XAML
<object x:Class="namespace.classname"...>
...
</object>
Valeurs XAML
namespace |
Facultatif. Spécifie un espace de noms CLR qui contient la classe partielle identifiée par classname. Si namespace est spécifié, un point (.) sépare namespace et namespace. |
classname |
Obligatoire. Spécifie le nom CLR de la classe partielle qui connecte le XAML chargé et votre code-behind pour ce XAML. |
Notes
x:Class peut être déclaré comme un attribut pour tout élément qui se trouve à la racine d'une arborescence d'éléments XAML (Extensible Application Markup Language) et est compilé (où XAML (Extensible Application Markup Language) est inclus dans un projet avec action de génération Page), ou pour la racine Application dans la définition d'application d'une application compilée. Une erreur de compilation sera générée en cas de déclaration de x:Class sur tout élément autre qu'une racine de page ou d'application, et dans toutes circonstances pour un fichier XAML (Extensible Application Markup Language) qui n'est pas compilé.
La classe utilisée comme x:Class ne peut pas être une classe imbriquée.
x:Class est facultatif en ce sens qu'il est parfaitement autorisé d'avoir une page XAML sans code-behind du tout, mais si votre page déclare des valeurs d'attribut de gestion des événements ou instancie des éléments personnalisés où les classes de définition se trouvent dans la classe code-behind, il convient de fournir la référence x:Class (ou x:Subclass) à la classe appropriée pour le code-behind.
La valeur de l'attribut x:Class doit être une chaîne qui spécifie le nom qualifié complet d'une classe. Pour les applications simples, vous pouvez omettre les informations sur les espaces de noms CLR tant que le code-behind est également structuré de cette manière (la définition 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 projet qui produit une application compilée. Vous devez suivre les règles de nom pour les classes CLR. Pour plus de détails, consultezDéfinitions de types Par défaut, la classe code-behind doit être public, mais peut être définie de manière à correspondre à un autre niveau d'accès en utilisant le x:ClassModifier, attribut.
Notez que cette signification de la valeur d'attribut x:Class est spécifique à l'implémentation WPFXAML. D'autres implémentations XAML en dehors de WPF ne peuvent pas utiliser le code managé et peuvent donc utiliser une autre formule de résolution de classe.
Voir aussi
Concepts
XAML et classes personnalisées