Attributo x:Class

Configura la compilazione XAML per unire classi parziali tra markup e code-behind. La classe parziale del codice viene definita in un file di codice separato e la classe parziale di markup viene creata dalla generazione del codice durante la compilazione XAML.

Utilizzo degli attributi XAML

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

Valori XAML

Termine	Description
Namespace	Optional. Specifica uno spazio dei nomi contenente la classe parziale identificata da classname. Se lo spazio dei nomi viene specificato, un punto (.) separa lo spazio dei nomi e il nomeclasse. Se lo spazio dei nomi viene omesso, si presuppone che classname non abbia uno spazio dei nomi.
classname	Obbligatorio. Specifica il nome della classe parziale che collega il XAML caricato con il code-behind associato a quel XAML.

Osservazioni:

X:Class può essere dichiarato come attributo per qualsiasi elemento che è la radice di un albero di file/oggetto XAML e viene compilato da azioni di compilazione o per la radice dell'applicazione nella definizione dell'applicazione di un'applicazione compilata. Dichiarando x:Class in qualsiasi elemento diverso da un nodo radice e in qualsiasi circostanza per un file XAML non compilato con l'azione di compilazione Page , viene generato un errore in fase di compilazione.

La classe usata come x:Class non può essere una classe nidificata.

Il valore dell'attributo x:Class deve essere una stringa che specifica il nome completo di una classe. È possibile omettere le informazioni sullo spazio dei nomi a condizione che il code-behind sia strutturato nello stesso modo (la definizione della classe inizia a livello di classe). Il file code-behind per una pagina o una definizione dell'applicazione deve trovarsi all'interno di un file di codice incluso come parte del progetto. La classe code-behind deve essere pubblica. La classe code-behind deve essere parziale.

Regole del linguaggio CLR

Anche se il file code-behind può essere un file C++, esistono alcune convenzioni che seguono ancora il modulo del linguaggio CLR, in modo che non vi sia alcuna differenza nella sintassi XAML. In particolare, il separatore tra i componenti dello spazio dei nomi e del nome della classe di qualsiasi valore di x:Class è sempre un punto ("."), anche se nel file di codice C++ associato a XAML il separatore tra lo spazio dei nomi e il nome della classe è "::". Se si dichiarano namespace annidati in C++, il separatore tra le stringhe successive del namespace annidato deve essere "." anziché "::" quando si specifica la parte namespace del valore x:Class.