Elemento pages (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Definisce globalmente le impostazioni di configurazione specifiche delle pagine, quali le direttive ASP.NET per le pagine e i controlli nell'ambito del file di configurazione.

Elemento configuration (schema delle impostazioni generali)
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento pages (schema delle impostazioni ASP.NET)

<pages     
   buffer="[True|False]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   smartNavigation="[True|False]"
   autoEventWireup="[True|False]"
   pageBaseType="typename, assembly"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   masterPageFile="file path" 
   theme="string"
   styleSheetTheme="string"
   maxPageStateFieldLength="number" 
   compilationMode="[Always|Auto|Never]" 
   pageParserFilterType="string" 
   viewStateEncryptionMode="[Always|Auto|Never]" 
   maintainScrollPositionOnPostBack="[True|False]" 
   asyncTimeout="number"
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
</pages>

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

asyncTimeout

Attributo TimeSpan facoltativo.

Specifica il numero di secondi di attesa per il completamento di un gestore asincrono durante l'elaborazione asincrona.

Questo attributo è nuovo in .NET Framework versione 2.0.

Il valore predefinito è "0:00:45" (45 secondi).

autoEventWireup

Attributo Boolean facoltativo.

Specifica se gli eventi di pagina vengono attivati automaticamente. Ciò accade se si verifica l'associazione automatica agli eventi, ovvero se vengono associati automaticamente i metodi di una determinata firma (ad esempio page_Load). Per ulteriori informazioni, vedere Modello di eventi dei controlli server Web ASP.NET.

Il valore predefinito è True.

buffer

Attributo Boolean facoltativo.

Specifica se la risorsa URL utilizza il buffer risposte.

Il valore predefinito è True.

compilationMode

Attributo CompilationMode facoltativo.

Specifica se è necessario compilare un controllo o una pagina ASP.NET in fase di esecuzione.

L'attributo compilationMode è nuovo in .NET Framework 2.0. Questo attributo può essere uno dei valori riportati di seguito. Il valore predefinito è Always.

Always

È necessario compilare sempre la pagina.

Auto

La pagina non verrà compilata da ASP.NET, se possibile.

Never

La pagina o il controllo non devono mai venire compilati in modo dinamico.

Se una pagina contiene un blocco di script o un costrutto di codice per cui è necessaria la compilazione, ASP.NET restituirà un errore e la pagina non verrà eseguita.

enableEventValidation

Specifica se le pagine e i controlli convalidano gli eventi di callback e postback. Il valore predefinito è True.

enableSessionState

Attributo String facoltativo.

Specifica i requisiti di stato della sessione per le risorse nell'ambito del file di configurazione.

L'attributo enableSessionState può essere uno dei valori riportati di seguito. Il valore predefinito è True.

Valore	Descrizione
False	Indica che lo stato sessione è disattivato.
ReadOnly	Indica che lo stato sessione non è modificabile.
True	Indica che lo stato sessione è attivato.

enableViewState

Attributo Boolean facoltativo.

Specifica se lo stato di visualizzazione è attivato e mantenuto su tutte le richieste di pagina.

Il valore predefinito è True.

enableViewStateMac

Attributo Boolean facoltativo.

Specifica se in ASP.NET è necessario eseguire codice MAC sullo stato di visualizzazione della pagina quando questa viene inviata dal client. Se è True, lo stato di visualizzazione crittografato viene controllato per verificare che non sia stato alterato nel client.

Il valore predefinito è True.

maintainScrollPositionOnPostBack

Attributo Boolean facoltativo.

Specifica se far tornare l'utente nella stessa posizione del browser del client quando viene eseguito il postback delle pagine al server. Se impostato su False, con il postback l'utente torna all'inizio della pagina.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è False.

masterPageFile

Attributo String facoltativo.

Specifica il percorso della pagina master relativo al file di configurazione locale. È necessario che le pagine, il cui attributo masterPageFile è impostato su True, contengano un controllo Content come controllo di primo livello.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è una stringa vuota ("").

maxPageStateFieldLength

Attributo Int32 facoltativo.

Specifica la lunghezza massima in caratteri per il campo dello stato della pagina. Quando l'attributo è impostato su un numero positivo, il campo dello stato di visualizzazione inviato al browser del client viene suddiviso in blocchi e la dimensione di ogni blocco è inferiore a quella specificata nell'attributo maxPageStateFieldLength. Se l'attributo è impostato su un numero negativo, il campo dello stato di visualizzazione non verrà separato in blocchi.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è "-1".

pageBaseType

Attributo String facoltativo.

Specifica la base da utilizzare quando sono presenti solo pagine autonome. Viene sottoposto a override dall'attributo inherits in un file autonomo.

Il valore predefinito è "System.Web.UI.Page".

pageParserFilterType

Attributo String facoltativo.

Specifica il nome di tipo di un filtro utilizzato dal parser ASP.NET per determinare se un elemento è consentito nella pagina in fase di analisi. È necessario che il filtro derivi dalla classe PageParserFilter.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è una stringa vuota ("").

smartNavigation

Attributo Boolean facoltativo.

Specifica se è attivata la funzionalità "smart navigation". Questa funzionalità richiede Microsoft Internet Explorer 5.5 o versione successiva. L'attivazione della funzionalità "smart navigation" comporta i seguenti vantaggi per l'utente:

Viene eliminato il lampeggio durante lo spostamento.
La posizione di scorrimento viene resa permanente tra le pagine.
Lo stato attivo di un elemento viene reso permanente tra le pagine.
L'ultimo stato della pagina è il solo memorizzato dalla cronologia del browser.

Questo attributo è nuovo in .NET Framework 2.0, ma è stato classificato come obsoleto a favore dell'attributo maintainScrollPositionOnPostBack.

Il valore predefinito è False.

styleSheetTheme

Attributo String facoltativo.

Specifica il nome della cartella del tema denominato da utilizzare per applicare il tema prima delle dichiarazioni dei controlli, in contrapposizione con l'attributo di tema che definisce il tema da applicare dopo la dichiarazione del controllo.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è una stringa vuota ("").

theme

Attributo String facoltativo.

Specifica il nome del tema utilizzato per le pagine comprese nell'ambito del file di configurazione. È necessario che il tema specificato esista come tema globale o applicazione. Se il tema non esiste, verrà generata un'eccezione HttpException.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è una stringa vuota ("").

userControlBaseType

Attributo String facoltativo.

Specifica la base da utilizzare quando sono presenti solo pagine autonome.

Il valore predefinito è "System.Web.UI.UserControl".

validateRequest

Attributo Boolean facoltativo.

Indica che in ASP.NET vengono esaminati tutti dati di input provenienti dal browser per individuare possibili dati pericolosi. Se è True, viene eseguita la convalida delle richieste confrontando tutti i dati di input con un elenco di possibili valori pericolosi. Se viene individuata una corrispondenza, viene generata un'eccezione HttpRequestValidationException.

Il valore predefinito è True.

viewStateEncryptionMode

Attributo ViewStateEncryptionMode facoltativo.

Specifica la modalità di crittografia dello stato di visualizzazione. La proprietà ViewStateEncryptionMode esegue l'override di questo attributo impostato nel file di configurazione.

Questo attributo può essere uno dei valori riportati di seguito.

Valore	Descrizione
Always	Lo stato di visualizzazione viene sempre crittografato.
Auto	Lo stato di visualizzazione viene crittografato se richiesto da un controllo.
Never	Lo stato di visualizzazione non viene mai crittografato, anche se richiesto da un controllo.

Questo attributo è nuovo in .NET Framework 2.0.

Il valore predefinito è Auto.

Elementi figlio

Elemento	Descrizione
controls	Definisce un insieme di direttive register e gli spazi dei nomi in cui si trovano i prefissi di tag.
namespaces	Definisce un insieme di direttive import da utilizzare durante la precompilazione dell'assembly.
tagMapping	Definisce un insieme di tipi di tag che vengono rimappati ad altri tipi di tag in fase di compilazione.

Elementi padre

Elemento	Descrizione
configuration	È l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni basate su .NET Framework.
system.web	Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento.

Note

L'elemento pages definisce le impostazioni di configurazione specifiche delle pagine. Questa sezione di configurazione supporta l'impostazione globale di determinate direttive dei controlli e delle pagine ASP.NET per tutte le pagine e i controlli nell'ambito del file di configurazione. Sono incluse le direttive a livello di pagina riportate di seguito che consentono di specificare le impostazioni utilizzate dalla pagina e dai compilatori del controllo utente per l'elaborazione della pagina Web Form ASP.NET (aspx) e dei file relativi al controllo utente (ascx).

Direttiva @ Page (@ Page).
Direttiva @ Import (@ Import) tramite l'elemento figlio namespaces.
Direttiva @ Register (@ Register) tramite l'elemento figlio controls.

L'elemento pages offre inoltre il supporto per il mapping dei tipi di tag agli altri tipi di tag in fase di esecuzione tramite l'elemento tagMapping.

Nota

L'aggiunta di una direttiva @ Page a una pagina master non consente l'utilizzo della stessa dichiarazione di direttiva nelle pagine che da questa dipendono. Per definire globalmente le direttive di pagina, è preferibile utilizzare l'elemento di configurazione pages.

Configurazione predefinita

L'elemento pages predefinito riportato di seguito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config principale. Si tratta, tuttavia, della configurazione predefinita restituita da un'applicazione. Gli spazi dei nomi e i controlli vengono aggiunti nel file Web.config di primo livello.

<pages 
   buffer="true" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come specificare diverse impostazioni di configurazione di pagina.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	PagesSection
Membro di configurazione	Pages Page
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Elemento pages (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive