@ Control
Aggiornamento: novembre 2007
Definisce gli attributi specifici di controllo utente (file ascx) utilizzati dal compilatore e dal parser di pagine ASP.NET. Questa direttiva può essere utilizzata solo con Controlli utente ASP.NET (il cui codice sorgente è contenuto nei file ascx).
<%@ Control attribute="value" [attribute="value" ... ] %>
Attributi
AutoEventWireup
Indica se gli eventi del controllo vengono connessi automaticamente. true indica che la connessione automatica degli eventi è attivata, false indica invece il caso contrario. L'impostazione predefinita è true. Per ulteriori informazioni, vedere Modello di eventi dei controlli server Web ASP.NET.ClassName
Stringa che specifica il nome della classe per il controllo che verrà compilato automaticamente in modo dinamico quando verrà richiesto. Per tale valore è possibile utilizzare qualsiasi nome di classe valido e includere lo spazio dei nomi completo di una classe (il nome completo di una classe). Se non viene specificato un valore per questo attributo, il nome della classe per il controllo compilato si basa sul nome file del controllo.Al nome della classe assegnato al controllo può fare riferimento un'altra pagina o un altro controllo mediante la direttiva @ Reference.
CodeBehind
Specifica il nome del file compilato contenente la classe associata al controllo. Questo attributo non viene utilizzato in fase di esecuzione.Nota
L'attributo è incluso per garantire la compatibilità con le versioni precedenti di ASP.NET, per implementare la funzionalità code-behind. In ASP.NET versione 2.0, invece, è necessario utilizzare l'attributo CodeFile per specificare il nome del file di origine, insieme all'attributo Inherits per specificare il nome completo della classe.
CodeFile
Specifica il percorso del file code-behind cui si fa riferimento per il controllo. Questo attributo viene utilizzato insieme all'attributo Inherits per associare un file di origine code-behind a un controllo utente. L'attributo è valido solo per i controlli compilati.CodeFileBaseClass
Specifica il percorso di una classe base per un controllo e la classe code-behind a esso associata. Questo attributo è facoltativo ma, quando viene utilizzato, è necessario che sia presente anche l'attributo CodeFile. Utilizzare questo attributo se si intende implementare uno scenario condiviso in cui si definiscono campi comuni (e facoltativamente gli eventi associati) in una classe base per fare riferimento ai controlli dichiarati in un controllo utente. A causa del modello di generazione del codice ASP.NET, se i campi venissero definiti in una classe senza utilizzare questo attributo, in fase di compilazione verrebbero generate nuove definizioni di membri per i controlli dichiarati nel controllo utente (all'interno di uno stub di classe parziale separato) e lo scenario desiderato non funzionerebbe. Se, tuttavia, si utilizza l'attributo CodeFileBaseClass per associare la classe base al controllo utente e si fa in modo che la classe parziale (il cui nome è assegnato all'attributo Inherits e al cui file di origine viene fatto riferimento dall'attributo CodeFile) erediti dalla classe base, i campi della classe base saranno in grado di fare riferimento ai controlli del controllo utente dopo la generazione di codice.CompilationMode
Imposta un valore che indica se il controllo deve essere compilato utilizzando una stringa che specifica una delle diverse opzioni enumerate. Il valore predefinito è Always, pertanto i controlli con estensione aspx vengono compilati per impostazione predefinita. Per informazioni dettagliate, vedere l'enumerazione CompilationMode.CompilerOptions
Stringa contenente le opzioni del compilatore utilizzate per la compilazione del controllo. In C# e Visual Basic si tratta di una sequenza di opzioni della riga di comando del compilatore. Per ulteriori informazioni sulle opzioni del compilatore, vedere Opzioni del compilatore C# o Compilatore di Visual Basic.Debug
Indica se è necessario compilare il controllo con i simboli di debug. true indica che è necessario compilare il controllo con i simboli di debug. false indica invece la situazione opposta. Questa impostazione influisce in modo significativo sulle prestazioni, pertanto è preferibile che l'attributo sia impostato solo su true durante lo sviluppo.Description
Fornisce una descrizione in formato testo del controllo. Questo valore viene ignorato dal parser ASP.NET.EnableTheming
Indica se sul controllo vengono utilizzati i temi. true se vengono utilizzati; in caso contrario false. L'impostazione predefinita è true.EnableViewState
Indica se lo stato della visualizzazione viene conservato su tutte le richieste di controllo. true indica che lo stato della visualizzazione viene mantenuto, false indica invece la situazione opposta. L'impostazione predefinita è true.Explicit
Determina se il controllo viene compilato utilizzando la modalità Option Explicit di Visual Basic. true indica che l'opzione di compilazione esplicita di Visual Basic è attivata e che tutte le variabili devono essere dichiarate tramite un'istruzione Dim, Private, Public o ReDim, false indica invece il caso contrario. L'impostazione predefinita è false.Nota
L'attributo viene ignorato dai linguaggi diversi da Visual Basic. Tale opzione viene inoltre impostata su true nel file di configurazione Machine.config. Per ulteriori informazioni, vedere File di configurazione del computer.
Inherits
Definisce una classe code-behind per il controllo da ereditare. Può essere una classe qualsiasi derivata dalla classe UserControl. Utilizzato con l'attributo CodeFile che contiene il percorso del file di origine per la classe code-behind. Per ulteriori informazioni sulle classi code-behind, vedere Modello di codice di pagine Web ASP.NET.Language
Specifica il linguaggio utilizzato nella compilazione del rendering inline (<% %> e <%= %>) e dei blocchi di dichiarazione del codice all'interno del controllo. I valori possono rappresentare qualsiasi linguaggio supportato da .NET Framework, inclusi Visual Basic, C# o JScript. È possibile utilizzare e specificare un solo linguaggio per controllo.LinePragmas
Determina se il runtime deve generare pragma di linea nel codice sorgente. Si tratta di opzioni del compilatore spesso utilizzate dagli strumenti di debug per contrassegnare posizioni specifiche in un file di origine. true se i pragma di linea devono essere generati, in caso contrario false.Src
Specifica un percorso di un file di origine contenente codice collegato al controllo. Nel file di origine collegato è possibile scegliere di includere logica di programmazione per il controllo in una classe o nei blocchi di dichiarazione del codice.È possibile utilizzare l'attributo Src per collegare i provider di generazione al controllo. Per ulteriori informazioni, vedere la classe BuildProvider. Nelle versioni di ASP.NET precedenti alla versione 2.0, inoltre, l'attributo Src veniva utilizzato come metodo alternativo per collegare un file code-behind a un controllo. In ASP.NET versione 2.0 l'approccio consigliato per il collegamento di un file di origine code-behind a un controllo consiste nell'utilizzare l'attributo Inherits, per specificare una classe, insieme all'attributo CodeFile, per specificare il percorso del file di origine per la classe.
Strict
Indica che il controllo deve essere compilato utilizzando la modalità OptionStrict di Visual Basic. true se la modalità Option Strict è attivata, in caso contrario false. L'impostazione predefinita è false.Nota
L'attributo viene ignorato dai linguaggi diversi da Visual Basic.
TargetSchema
Specifica il nome di uno schema che convalida il contenuto sul controllo. Lo scopo di questo attributo è di carattere esclusivamente descrittivo, non viene eseguita alcuna convalida effettiva e l'attributo viene ignorato dal parser.WarningLevel
Indica il livello di avviso del compilatore raggiunto il quale gli avvisi devono essere considerati come errori interrompendo la compilazione del controllo. I livelli di avviso possibili sono compresi tra 0 e 4. Per ulteriori informazioni, vedere la proprietà WarningLevel.
Note
È possibile utilizzare questa direttiva solo nei controlli utente. I controlli utente vengono definiti in file con estensione ASCX. È possibile includere una sola direttiva @ Control in ogni file con estensione ascx. È, inoltre, possibile definire un solo attributo Language per ogni direttiva @ Control, in quanto per ciascun controllo è possibile utilizzare un solo linguaggio.
Nota
La direttiva @ Control ha una serie di attributi in comune con altre direttive che si applicano a un intero file di origine, ad esempio la direttiva @ Page (utilizzata nei file aspx per le pagine Web) e la direttiva @ Master (utilizzata nei file con estensione master per le pagine master).
Per definire più attributi per la direttiva @ Control, separare ogni coppia attributo/valore inserendo uno spazio singolo. Per un attributo specifico non inserire uno spazio prima e dopo il segno di uguale (=) che collega l'attributo al rispettivo valore. Per un esempio, vedere la sezione Esempio del presente argomento.
Esempio
Nell'esempio di codice riportato di seguito viene indicato al compilatore di pagina ASP.NET di utilizzare Visual Basic come linguaggio di codice inline e viene disattivato il salvataggio dello stato della visualizzazione nelle richieste HTTP utilizzando l'attributo EnableViewState.
<%@ Control Language="VB" EnableViewState="false" %>