@ Master
Aggiornamento: novembre 2007
Definisce gli attributi specifici della pagina master (file con estensione master) utilizzati dal compilatore e dal parser di pagine ASP.NET.
<%@ Master attribute="value" [attribute="value"...] %>
Attributi
Argomento |
Definizione |
|---|---|
AutoEventWireup |
Indica se è possibile definire gestori eventi semplici per specifiche fasi del ciclo di vita utilizzando la sintassi Page senza un aggancio esplicito o una firma di evento. true se il wireup automatico degli eventi è attivato; in caso contrario false. Il valore predefinito è true. Per ulteriori informazioni, vedere Modello di eventi dei controlli server Web ASP.NET. |
ClassName |
Specifica il nome della classe generata automaticamente dal codice e compilata durante l'elaborazione della pagina master. Per tale valore è possibile utilizzare qualsiasi nome di classe valido e includere uno spazio dei nomi. |
CodeFile |
Specifica il nome di un file distinto che contiene una classe parziale con i gestori eventi e altro codice specifico della pagina master. Per ulteriori informazioni, vedere Modello di codice di pagine Web ASP.NET. |
CompilationMode |
Specifica se compilare una pagina master ASP.NET in fase di esecuzione. Le opzioni disponibili sono Always per compilare sempre la pagina, Auto per evitare di compilare la pagina ove possibile e Never per non compilare mai la pagina o il controllo. Il valore predefinito è Always. |
CompilerOptions |
Fornisce una stringa contenente le opzioni del compilatore da utilizzare per compilare la pagina. In C# e Microsoft Visual Basic si tratta di una sequenza di opzioni della riga di comando del compilatore. |
Debug |
Indica se compilare la pagina master con i simboli di debug. true per compilare con i simboli di debug; in caso contrario false. |
Description |
Fornisce una descrizione in formato testo della pagina master. Questo valore viene ignorato dal parser ASP.NET. |
EnableTheming |
Indica se è possibile modificare l'aspetto della pagina master e dei relativi controlli, se viene applicato un tema. true se è possibile applicare un tema; in caso contrario false. Il valore predefinito è true. L'impostazione dell'attributo EnableTheming risulta particolarmente utile quando nel file Web.config viene definito un tema di pagina e per impostazione predefinita viene applicato a tutte le pagine. Per ulteriori informazioni, vedere Cenni preliminari su temi e interfacce ASP.NET. |
EnableViewState |
Indica se lo stato di visualizzazione viene mantenuto tra una richiesta di pagina e l'altra. true per mantenere lo stato di visualizzazione; in caso contrario false. Il valore predefinito è true. |
Explicit |
Determina se la pagina viene compilata 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; in caso contrario false. Il valore predefinito è false. Nota L'attributo Explicit viene ignorato dai linguaggi diversi da Visual Basic. L'attributo Explicit è impostato su true nel file Machine.config. Per ulteriori informazioni, vedere File di configurazione del computer. |
Inherits |
Specifica una classe code-behind da cui la pagina deve ereditare. Può essere una classe qualsiasi derivata dalla classe MasterPage. Per informazioni sulle classi code-behind, vedere Cenni preliminari sulla classe delle pagine ASP.NET. |
Language |
Specifica il linguaggio utilizzato nella compilazione di tutto il rendering inline (<% %> e <%= %>) e dei blocchi di dichiarazione del codice all'interno della pagina. I valori possono rappresentare qualsiasi linguaggio supportato da .NET Framework, tra cui VB (Visual Basic), C# e JScript. |
LinePragmas |
Determina se il runtime deve generare pragma nel codice generato. |
MasterPageFile |
Specifica il file con estensione master che funge da pagina master per una pagina master. L'attributo MasterPageFile viene utilizzato in una pagina master quando viene definita una pagina master figlio in uno scenario di pagine master nidificate. Per informazioni dettagliate, vedere Pagine master ASP.NET nidificate. |
Src |
Specifica il nome del file di origine della classe di codice sottostante da compilare in modo dinamico quando viene richiesta la pagina. È possibile scegliere di includere la logica di programmazione per la pagina in una classe code-behind oppure nei Blocchi di dichiarazione del codice nel file aspx. |
Strict |
Specifica se compilare la pagina utilizzando la modalità Option Strict di Visual Basic. true se la modalità Option Strict è attivata; in caso contrario false. Il valore predefinito è false. Nota L'attributo Strict viene ignorato dai linguaggi diversi da Visual Basic. |
WarningLevel |
Specifica il livello di avviso del compilatore in corrispondenza del quale interrompere la compilazione della pagina. I valori possibili sono compresi tra 0 e 4. Per ulteriori informazioni, vedere WarningLevel. |
Note
La direttiva @ Master può essere utilizzata solo nelle pagine master. Le pagine master vengono definite in file con estensione master. È possibile includere una sola direttiva @ Master in ogni file con estensione master.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come indicare al compilatore di pagine ASP.NET di utilizzare Visual Basic come linguaggio codice inline. Il codice di gestione eventi viene definito in una classe parziale denominata MasterPageSample. Il codice relativo alla classe MasterPageSample è disponibile nel file MasterPageSample.master.vb.
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>