Attributo x:Class
Aggiornamento: novembre 2007
Configura la compilazione XAML per associare le classi parziali tra markup e code-behind. La classe parziale del codice viene definita in un file di codice separato in un linguaggio Common Language Specification (CLS), mentre la classe parziale del markup viene creata dalla generazione del codice durante la compilazione XAML.
Utilizzo della sintassi XAML per gli attributi
<object x:Class="namespace.classname"...>
...
</object>
Valori XAML
namespace |
Facoltativo. Specifica uno spazio dei nomi CLR contenente la classe parziale identificata da classname. Se l'oggetto namespace viene specificato, un punto (.) separa namespace e namespace. |
classname |
Obbligatorio. Specifica il nome CLR della classe parziale che connette la sintassi XAML caricata e il code-behind per quella sintassi XAML. |
Note
L'oggetto x:Class può essere dichiarato come attributo per un elemento che rappresenta la radice di una struttura ad albero dell'elemento Extensible Application Markup Language (XAML) che si compila (in cui la sintassi Extensible Application Markup Language (XAML) è inclusa in un progetto con operazione di compilazione Page) o per la radice Application nella definizione dell'applicazione di un'applicazione compilata. La dichiarazione dell'attributo x:Class in un elemento diverso da una radice della pagina o da una radice dell'applicazione e in qualsiasi circostanza per un file Extensible Application Markup Language (XAML) che non è compilato comporterà un errore in fase di compilazione.
La classe utilizzata come oggetto x:Class non può essere una classe nidificata.
L'oggetto x:Class è facoltativo nel senso che è consentito disporre di una pagina XAML senza code-behind; tuttavia, se nella pagina vengono dichiarati i valori dell'attributo di gestione eventi oppure si creano istanze di elementi personalizzati in cui le classi di definizione si trovano all'interno della classe code-behind, è necessario fornire il riferimento all'attributo x:Class (oppure x:Subclass) per la classe appropriata per il code-behind.
Il valore dell'attributo x:Class deve essere una stringa che specifica il nome completo di una classe. Per le applicazioni semplici, è possibile omettere le informazioni sullo spazio dei nomi CLR purché la struttura del code-behind lo consenta (la definizione inizia a livello di classe). Il file code-behind per la definizione di una pagina o di un'applicazione deve essere all'interno di un file di codice incluso come parte del progetto che genera un'applicazione compilata. È necessario seguire le regole dei nomi per le classi CLR; per informazioni dettagliate, vedere Type Definitions (informazioni in lingua inglese). Per impostazione predefinita, la classe code-behind deve essere public, tuttavia può essere definita per disporre di un livello di accesso diverso mediante l'oggetto Attributo x:ClassModifier.
Notare che questo significato del valore dell'attributo x:Class è specifico dell'implementazione XAML di WPF. Altre implementazioni XAML esterne a WPF potrebbero non utilizzare codice gestito e pertanto ricorrere a una formula di risoluzione delle classi diversa.