Condividi tramite


Classe HttpRuntimeSection

Configura le impostazioni di run-time HTTP ASP.NET che determinano la modalità di elaborazione di una richiesta per un'applicazione ASP.NET specificata.

Sintassi

class HttpRuntimeSection : ConfigurationSection  

Metodi

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

Nome Descrizione
GetAllowDefinition Ereditato da ConfigurationSection.
GetAllowLocation Ereditato da ConfigurationSection.
RevertToParent Ereditato da ConfigurationSection.
SetAllowDefinition Ereditato da ConfigurationSection.
SetAllowLocation Ereditato da ConfigurationSection.

Proprietà

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

Nome Descrizione
ApartmentThreading Valore di lettura/scrittura boolean facoltativo. true se il threading di appartamento è abilitato per la compatibilità ASP classica; in caso contrario, false. Il valore predefinito è false. Nota: Questa proprietà è nuova in .NET Framework 2.0.
AppRequestQueueLimit Valore di lettura/scrittura sint32 facoltativo che specifica il numero massimo di richieste che ASP.NET code per l'applicazione. Il valore predefinito è 5000. Nota: Per .NET Framework versioni 1.0 e 1.1, l'impostazione predefinita è 100.

Quando non sono presenti thread sufficienti per elaborare una richiesta, le richieste vengono accodate. Quando il numero di richieste nella coda supera il limite specificato in questa proprietà, le richieste in ingresso vengono rifiutate con l'errore "503 - Server Troppo occupato".
DelayNotificationTimeout Valore di lettura/scrittura datetime facoltativo che specifica il timeout per ritardare le notifiche. Il valore predefinito è 5 secondi. Nota: Questa proprietà è nuova in .NET Framework 2.0.
Enable Valore di lettura/scrittura boolean facoltativo. true se il dominio dell'applicazione (AppDomain) è abilitato per accettare richieste in ingresso a livello di nodo corrente e figlio; in caso contrario, false. Il valore predefinito è true. Se false, l'applicazione è effettivamente disattivata.
EnableHeaderChecking Valore di lettura/scrittura boolean facoltativo. true se ASP.NET deve controllare l'intestazione della richiesta per potenziali attacchi di inserimento; in caso contrario, false. Il valore predefinito è true. Se viene rilevato un attacco, ASP.NET risponde con un errore. Nota: Questa proprietà è nuova in .NET Framework 2.0.
EnableKernelOutputCache Valore di lettura/scrittura boolean facoltativo. true se la cache di output è abilitata; in caso contrario, false. Il valore predefinito è true.

Questo attributo è rilevante solo quando è installato IIS 6.0 o 7.0. La configurazione della memorizzazione nella cache dell'output e il tipo di richiesta determina se il contenuto può essere memorizzato nella cache.

Per memorizzare nella cache una risposta, è necessario assicurarsi che siano soddisfatti i criteri seguenti:

- La memorizzazione nella cache deve essere abilitata in modo esplicito da una direttiva di pagina o tramite l'API di memorizzazione nella cache.
- La memorizzazione nella cache deve avere un criterio di scadenza in modo che il kernel riconosca quando eliminare la risposta.
- La memorizzazione nella cache non include intestazioni o parametri di variabile.
- L'autenticazione non è necessaria.
EnableVersionHeader Valore di lettura/scrittura boolean facoltativo. true se ASP.NET deve restituire un'intestazione di versione; in caso contrario, false. Il valore predefinito è true.

Visual Studio 2005 usa questa proprietà per determinare quale versione di ASP.NET è in uso. Questa proprietà non è necessaria per i siti di produzione e può essere disabilitata.
ExecutionTimeout Valore facoltativo di lettura/scrittura datetime che specifica il tempo massimo di esecuzione di una richiesta prima di arrestarlo automaticamente ASP.NET. Il valore predefinito è 1 minuto, 50 secondi.

Questo timeout si applica solo se la Debug proprietà nella classe CompilationSection è false. Per evitare di arrestare l'applicazione durante il debug, non impostare questo timeout su un valore di grandi dimensioni.
Location Ereditato da ConfigurationSection.) Proprietà chiave.
MaxRequestLength Valore di lettura/scrittura sint32 facoltativo che specifica il limite, in kilobyte, per la soglia di buffering del flusso di input. Il valore predefinito è 4096 (4 MB).

È possibile usare questo limite per impedire attacchi denial of service causati, ad esempio, dagli utenti che registrano file di grandi dimensioni nel server.
MaxWaitChangeNotification Valore facoltativo di lettura/scrittura sint32 che specifica il tempo massimo, in secondi, per attendere dopo la prima notifica di modifica del file prima che il dominio dell'applicazione venga riavviato per una nuova richiesta. Il valore predefinito è 0.

Impostare questa proprietà su un numero maggiore del tempo necessario per completare i processi di copia file. Le notifiche di modifica dei file vengono combinate in base al valore di questa proprietà e alla WaitChangeNotification proprietà. Nota: Questa proprietà è nuova in .NET Framework 2.0.
MinFreeThreads Valore di lettura/scrittura sint32 facoltativo che specifica il numero minimo di thread che ASP.NET mantiene disponibile per le richieste che richiedono thread aggiuntivi per completare l'elaborazione. Il valore predefinito è 8.
MinLocalRequestFreeThreads Valore di lettura/scrittura sint32 facoltativo che specifica il numero minimo di thread che ASP.NET mantiene disponibile per le richieste locali che richiedono thread aggiuntivi per completare l'elaborazione. Il valore predefinito è 4. Nota: Il numero specificato di thread è riservato alle richieste provenienti dall'host locale, nel caso in cui alcune di queste richieste esegano richieste figlio durante l'elaborazione. Ciò consente di evitare un deadlock possibile con reentry ricorsivo nel server Web.
Path Ereditato da ConfigurationSection.) Proprietà chiave.
RequestLengthDiskThreshold Valore di lettura/scrittura sint32 facoltativo che specifica, in byte, il limite per la soglia di buffering del flusso di input. L'impostazione predefinita è 256.

Questo valore non deve superare il valore nella MaxRequestLength proprietà. Nota: Questa proprietà è nuova in .NET Framework 2.0.
RequireRootedSaveAsPath Valore di lettura/scrittura boolean facoltativo. true se il filename parametro in un SaveAs metodo deve essere un percorso assoluto; in caso contrario, false. Il valore predefinito è true.

Il processo di ASP.NET deve disporre dell'autorizzazione per creare file nel percorso specificato. Nota: Questa proprietà è nuova in .NET Framework 2.0.
SectionInformation Ereditato da ConfigurationSection.
SendCacheControlHeader Valore di lettura/scrittura boolean facoltativo. true se un'intestazione del controllo cache impostata su Private viene inviata per impostazione predefinita; in caso contrario, false. Se truela memorizzazione nella cache lato client è disabilitata. Il valore predefinito è true. Nota: Questa proprietà è nuova in .NET Framework 2.0.
ShutdownTimeout Valore di lettura/scrittura datetime facoltativo che specifica l'ora consentita per l'arresto di un processo di lavoro. Il valore predefinito è 1 minuto, 30 secondi.

Al termine del timeout, ASP.NET arresta il processo di lavoro. Nota: Questa proprietà è nuova in .NET Framework 2.0.
UseFullyQualifiedRedirectUrl Valore di lettura/scrittura boolean facoltativo. true se i reindirizzamenti sul lato client sono completi; in caso contrario, false. Il valore predefinito è false.

Per qualificare completamente i reindirizzamenti lato client, usare il formato http://server/path. Questo formato è obbligatorio per alcuni controlli per dispositivi mobili. Se true, tutti i reindirizzamenti non completi vengono convertiti automaticamente in un formato completo. Se false, i reindirizzamenti relativi vengono inviati al client. Nota: Se false, alcuni browser potrebbero riscontrare problemi durante il caricamento di pagine che si trovano in sessioni senza cookie.
WaitChangeNotification Valore facoltativo di lettura/scrittura sint32 che specifica il tempo, espresso in secondi, per attendere un'altra notifica di modifica del file prima del riavvio del dominio applicazione. Il valore predefinito è 0.

Impostare questo attributo su un numero maggiore del tempo tra gli aggiornamenti di due notifiche di modifica della copia file. Le notifiche di modifica dei file vengono combinate in base al valore di questa proprietà e alla MaxWaitChangeNotification proprietà . Nota: Questa proprietà è una novità di .NET Framework 2.0.

Sottoclassi

Questa classe non contiene sottoclassi.

Gerarchia di ereditarietà

Configurationsection

HttpRuntimeSection

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

System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
Classe ConfigurationSection
Classe CompilationSection
CIM_DATETIME