Classe PagesSection

Articolo
03/16/2023

Rappresenta la <pages> sezione di un file di Web.config.

Sintassi

class PagesSection : ConfigurationSectionWithCollection

Metodi

Nella tabella seguente sono elencati i metodi esposti dalla PagesSection classe .

Nome	Descrizione
Aggiungere	Ereditato da ConfigurationSectionWithCollection.
Cancella	Ereditato da `ConfigurationSectionWithCollection`.
Recupero	Ereditato da `ConfigurationSectionWithCollection`.
GetAllowDefinition	Ereditato da ConfigurationSection.
GetAllowLocation	Ereditato da `ConfigurationSection`.
Rimuovi	Ereditato da `ConfigurationSectionWithCollection`.
RevertToParent	Ereditato da `ConfigurationSection`.
SetAllowDefinition	Ereditato da `ConfigurationSection`.
SetAllowLocation	Ereditato da `ConfigurationSection`.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla PagesSection classe .

Nome	Descrizione
`AsyncTimeout`	Valore di lettura/scrittura `datetime` che specifica l'ora in cui la pagina attenderà l'esecuzione di attività asincrone. Il valore predefinito è 45 secondi.
`AutoEventWireup`	Valore di lettura/scrittura `boolean` . `true` se gli eventi per le pagine ASP.NET vengono connessi automaticamente alle funzioni di gestione degli eventi; in caso contrario, `false`. Il valore predefinito è `true`. Nota: Quando questa proprietà è `true`, ASP.NET non richiede eventi per specificare gestori eventi, ad `Page_Load` esempio o `Page_Init`. Ciò significa che la `Handles` parola chiave in Visual Basic non è necessaria nello script del server nella pagina Web Forms. Per impostazione predefinita, quando l'applicazione Web ASP.NET viene creata in Visual Studio, il valore della `AutoEventWireup` proprietà è impostato su `false` nella pagina aspx o nel controllo ascx e i gestori eventi non vengono creati automaticamente. Non impostare su `AutoEventWireuptrue` se le prestazioni sono una considerazione chiave.
`Buffer`	Valore di lettura/scrittura `boolean` . `true` se le pagine aspx e i controlli ascx utilizzano il buffer risposte; in caso contrario, `false`. Il valore predefinito è `true`. Nota: Quando il buffer delle risposte è attivato, l'output della pagina o del controllo viene memorizzato nel buffer fino a quando non viene elaborata l'intera pagina o l'intero controllo. Non impostare questa proprietà su `true` se le prestazioni sono una considerazione chiave.
`CompilationMode`	Enumerazione di lettura/scrittura `sint32` che specifica se le pagine aspx e i controlli ascx vengono compilati in fase di esecuzione. I valori possibili sono elencati più avanti nella sezione Osservazioni.
`Controls`	Valore TagPrefixInfo che contiene informazioni di configurazione per i controlli personalizzati e utente.
`EnableEventValidation`	Valore `boolean`. `true` se è necessario eseguire la convalida degli eventi; in caso contrario, `false`. Il valore predefinito è `true`. Il meccanismo di convalida degli eventi elimina il rischio di richieste di postback non autorizzate e callback da un controllo. Durante il rendering, un controllo registra i relativi eventi e quindi convalida solo gli eventi specifici che possono essere generati sul controllo durante una richiesta di postback o un callback. Tutti i controlli basati su eventi in ASP.NET ora usano questa funzionalità per impostazione predefinita. Tuttavia, è possibile ripristinare il comportamento di .NET Framework versione 1.0 disabilitando facoltativamente la convalida degli eventi per un'applicazione Web. Nota: Il controllo di base controlla questa proprietà per determinare se deve convalidare gli eventi. Un controllo derivato non eredita questa impostazione del controllo di base, pertanto per impostazione predefinita è esente dalla convalida degli eventi. È comunque possibile indicare ASP.NET di eseguire la convalida degli eventi nel controllo derivato aggiungendo la `EnableEventValidation` proprietà al controllo derivato stesso e impostandola su `true`.
`EnableSessionState`	Valore di lettura/scrittura `sint32` che specifica se lo stato della sessione è abilitato. I valori possibili sono elencati più avanti nella sezione Osservazioni.
`EnableViewState`	Valore di lettura/scrittura `boolean` . `true` se lo stato di visualizzazione è abilitato; in caso contrario, `false.` il valore predefinito è `true`.
`EnableViewStateMac`	Valore di lettura/scrittura `boolean` . `true` se ASP.NET deve eseguire un controllo di autenticazione dei messaggi sullo stato di visualizzazione della pagina quando la pagina viene pubblicata dal client; in caso contrario, `false`. Il valore predefinito è `true`. Nota: Per motivi di sicurezza, questa proprietà deve essere sempre impostata su true.
`Location`	Ereditato da `ConfigurationSection`. Proprietà chiave.
`MaintainScrollPositionOnPostBack`	Valore di lettura/scrittura `boolean` . `true` se la posizione di scorrimento della pagina del browser deve essere mantenuta dopo il postback; in caso contrario, `false`. Il valore predefinito è `false`.
`MasterPageFile`	Valore di lettura/scrittura `string` che specifica un riferimento alla pagina master per l'applicazione. La stringa può contenere un percorso relativo o assoluto.
`MaxPageStateFieldLength`	Valore di lettura/scrittura `sint32` che specifica il numero massimo di caratteri che un singolo campo dello stato di visualizzazione può contenere. Il valore predefinito è -1 (nessun limite specificato). Se la lunghezza dei dati archiviati supera il valore specificato, i dati vengono suddivisi tra più campi dello stato di visualizzazione.
`Namespaces`	Valore NamespaceInfo che contiene riferimenti allo spazio dei nomi importati automaticamente in tutte le pagine di un'applicazione Web. In questo modo le classi degli spazi dei nomi specificati sono disponibili per l'uso nella pagina.
`PageBaseType`	Valore di lettura/scrittura `string` che specifica una classe code-behind che le pagine aspx ereditano per impostazione predefinita. Il valore predefinito è "System.Web.UI.Page".
`PageParserFilterType`	Valore di lettura/scrittura `string` che specifica il tipo di filtro del parser. Un filtro parser è un'istanza della classe System.Web.UI.PageParserFilter . In fase di esecuzione, il processo di compilazione della pagina chiama il filtro del parser per verificare la presenza di modifiche al codice sorgente prima dell'analisi della pagina.
`Path`	Ereditato da `ConfigurationSection`. Proprietà chiave.
`SectionInformation`	Ereditato da `ConfigurationSection`.
`SmartNavigation`	Valore di lettura/scrittura `boolean` . `true` se la smart navigation è abilitata; in caso contrario, `false`. Il valore predefinito è `false`. Nota: Lo spostamento intelligente richiede Microsoft Internet Explorer 5.5, 6 o 7.
`StyleSheetTheme`	Valore di lettura/scrittura `string` che specifica il nome di un tema del foglio di stile ASP.NET.
`TagMapping`	Valore TagMapInfo che contiene istruzioni di rimmapping dei tag di configurazione. Questa proprietà consente di rieseguire il mapping dei tipi di tag in fase di compilazione. Il mapping fa sì che il tipo mappato venga usato al posto del tipo di tag originale per tutte le pagine e i controlli nell'applicazione ASP.NET nell'ambito del file di configurazione.
`Theme`	Valore di lettura/scrittura `string` che specifica il nome di un tema di pagina ASP.NET.
`UserControlBaseType`	Valore di lettura/scrittura `string` che specifica una classe code-behind che i controlli utente ereditano per impostazione predefinita. Il valore predefinito è "System.Web.UI.UserControl".
`ValidateRequest`	Valore di lettura/scrittura `boolean` . `true` se ASP.NET esegue la convalida delle richieste su tutti gli input del browser; in caso contrario, `false`. Il valore predefinito è `true`. La convalida della richiesta viene eseguita confrontando i dati di input con un elenco di valori potenzialmente pericolosi. Se si verifica una corrispondenza, ASP.NET genera un'eccezione System.Web.HttpRequestValidationException.
`ViewStateEncryptionMode`	Enumerazione di lettura/scrittura `sint32` che specifica la modalità di crittografia utilizzata ASP.NET per i valori dello stato di visualizzazione. I valori possibili sono elencati più avanti nella sezione Osservazioni.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Nella tabella seguente sono elencati i valori possibili per la CompilationMode proprietà. Il valore predefinito è 2 (Always).

Valore	Parola chiave	Descrizione
0	`Auto`	ASP.NET non compila la pagina, se possibile.
1	`Never`	La pagina o il controllo non viene mai compilato dinamicamente. Questa impostazione aumenta le prestazioni squalificando la pagina specificata dal processo di compilazione. Se una pagina contiene un costrutto di script o di codice che richiede la compilazione, ASP.NET restituisce un errore e la pagina non viene eseguita.
2	`Always`	La pagina deve sempre essere compilata.

Nella tabella seguente sono elencati i valori possibili per la EnableSessionState proprietà. Il valore predefinito è 2 (True).

Valore	Parola chiave	Descrizione
0	`False`	Lo stato della sessione è disabilitato.
1	`ReadOnly`	Lo stato della sessione è di sola lettura.
2	`True`	Lo stato della sessione è abilitato.

Nella tabella seguente sono elencati i valori possibili per la ViewStateEncryptionMode proprietà. Il valore predefinito è 0 (Auto).

Valore	Parola chiave	Descrizione
0	`Auto`	Le informazioni sullo stato di visualizzazione vengono crittografate se un controllo richiede la crittografia chiamando il metodo System.Web.UI.Page.RegisterRequiresViewStateEncryption .
1	`Always`	Le informazioni sullo stato di visualizzazione sono sempre crittografate.
2	`Never`	Le informazioni sullo stato di visualizzazione non sono mai crittografate, anche se un controllo richiede la crittografia.

Gerarchia di ereditarietà

Configurationsection

ConfigurationSectionWithCollection

PagesSection

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedere anche

Microsoft.Web.Management.Client.Win32.ModulePage.Microsoft.Web.Management.Client.IModulePage.Initialize
System.Web.UI.Page.RegisterRequiresViewStateEncryption
System.Web.Configuration.PagesSection System.Web.HttpRequestValidationException
Classe AspSession
Classe ConfigurationSectionWithCollection
Classe NamespaceInfo
Classe SessionPageStateSection
Classe SessionStateSection
Classe TagMapElement
Classe TagMapInfo
Classe TagPrefixElement
Classe TagPrefixInfo
Enumerazione CompilationMode

Condividi tramite