Classe HttpRuntimeSection

Article
03/25/2024

Configure les paramètres d’exécution HTTP ASP.NET qui déterminent la façon dont une requête est traitée pour une application ASP.NET donnée.

Syntaxe

class HttpRuntimeSection : ConfigurationSection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe HttpRuntimeSection.

Nom	Description
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe HttpRuntimeSection.

Nom	Description
`ApartmentThreading`	Une valeur `boolean` en lecture/écriture facultative. `true` si le thread cloisonné est activé pour la compatibilité ASP classique ; sinon, `false`. Par défaut, il s’agit de `false`. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`AppRequestQueueLimit`	Une valeur de lecture/écriture `sint32` facultative qui spécifie le nombre maximal de requêtes que ASP.NET met en file d’attente pour l’application. L'option par défaut est 5 000. Remarque : pour les versions 1.0 et 1.1 de .NET Framework, la valeur par défaut est 100. Lorsqu’il n’y a pas suffisamment de threads libres pour traiter une demande, les demandes sont mises en file d’attente. Lorsque le nombre de requêtes dans la file d’attente dépasse la limite spécifiée dans cette propriété, les requêtes entrantes sont rejetées avec l’erreur « 503 : Serveur encombré ».
`DelayNotificationTimeout`	Une valeur en lecture/écriture `datetime` facultative qui spécifie le délai d’attente pour retarder les notifications. La valeur par défaut est 5 secondes. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`Enable`	Une valeur `boolean` en lecture/écriture facultative. `true` si le domaine d’application (AppDomain) est activé pour accepter les demandes entrantes aux niveaux actuels et enfants du nœud ; sinon, `false`. Par défaut, il s’agit de `true`. Si `false`, l’application est désactivée.
`EnableHeaderChecking`	Une valeur `boolean` en lecture/écriture facultative. `true` si ASP.NET doit vérifier l’en-tête de demande pour les attaques potentielles par injection ; sinon, `false`. Par défaut, il s’agit de `true`. Si une attaque est détectée, ASP.NET répond avec une erreur. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`EnableKernelOutputCache`	Une valeur `boolean` en lecture/écriture facultative. `true` si la mise en cache de sortie est activée ; sinon, `false`. Par défaut, il s’agit de `true`. Cet attribut est pertinent uniquement lorsque IIS 6.0 ou 7.0 est installé. La configuration de la mise en cache de la sortie et le type de demande déterminent si le contenu peut être mis en cache. Pour mettre en cache une réponse, vous devez vous assurer que les critères suivants sont remplis : - La mise en cache doit être explicitement activée par une directive de page ou à l’aide de l’API de mise en cache. - La mise en cache doit avoir une stratégie d’expiration afin que le noyau reconnaisse quand ignorer la réponse. - La mise en cache n’a pas d’en-têtes ou de paramètres de variable. - L’authentification n’est pas requise.
`EnableVersionHeader`	Une valeur `boolean` en lecture/écriture facultative. `true` si ASP.NET doit générer un en-tête de version ; sinon, `false`. Par défaut, il s’agit de `true`. Visual Studio 2005 utilise cette propriété pour déterminer la version de ASP.NET utilisée. Cette propriété n’est pas nécessaire pour les sites de production et peut être désactivée.
`ExecutionTimeout`	Une valeur en lecture/écriture `datetime` facultative qui spécifie la durée maximale pendant laquelle une demande est autorisée à s’exécuter avant que ASP.NET ne l’arrête automatiquement. La valeur par défaut est de 1 minute, 50 secondes. Ce délai d’attente s’applique uniquement si la propriété `Debug` de la classe CompilationSection est `false`. Pour éviter d’arrêter l’application pendant le débogage, ne définissez pas ce délai d’attente sur une valeur importante.
`Location`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`MaxRequestLength`	Une valeur en lecture/écriture `sint32` facultative qui spécifie la limite, en kilo-octets, pour le seuil de mise en mémoire tampon du flux d’entrée. La valeur par défaut est 4096 (4 Mo). Vous pouvez utiliser cette limite pour empêcher les attaques par déni de service qui sont provoquées, par exemple, par les utilisateurs qui publient des fichiers volumineux sur le serveur.
`MaxWaitChangeNotification`	Une valeur en lecture/écriture `sint32` facultative qui spécifie la durée maximale, en secondes, d’attendre après la première notification de modification de fichier avant le redémarrage du domaine d’application pour une nouvelle requête. La valeur par défaut est 0. Définissez cette propriété sur un nombre supérieur à la durée d’exécution des processus de copie de fichiers. Les notifications de modification de fichier sont combinées en fonction de la valeur de cette propriété et de la propriété `WaitChangeNotification`. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`MinFreeThreads`	Une valeur en lecture/écriture `sint32` facultative qui spécifie le nombre minimal de threads que ASP.NET garde disponible pour les demandes nécessitant des threads supplémentaires pour terminer le traitement. La valeur par défaut est 8.
`MinLocalRequestFreeThreads`	Une valeur en lecture/écriture `sint32` facultative qui spécifie le nombre minimal de threads que ASP.NET garde disponible pour les requêtes locales nécessitant des threads supplémentaires pour terminer le traitement. Valeur par défaut : 4. Remarque : le nombre spécifié de threads est réservé aux requêtes provenant de l’hôte local, dans le cas où certaines de ces demandes émettent des demandes enfants pendant le traitement. Cela permet d’éviter un blocage possible avec une réintroduction récursive sur le serveur Web.
`Path`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`RequestLengthDiskThreshold`	Une valeur de lecture/écriture `sint32` facultative qui spécifie, en octets, la limite du seuil de mise en mémoire tampon du flux d’entrée. La valeur par défaut est 256. Cette valeur ne doit pas dépasser la valeur dans la propriété `MaxRequestLength`. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`RequireRootedSaveAsPath`	Une valeur `boolean` en lecture/écriture facultative. `true` si le paramètre `filename` d’une méthode `SaveAs` doit être un chemin d’accès absolu ; sinon, `false`. Par défaut, il s’agit de `true`. Le processus ASP.NET doit avoir l’autorisation de créer des fichiers à l’emplacement spécifié. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`SectionInformation`	(Hérité de `ConfigurationSection`.)
`SendCacheControlHeader`	Une valeur `boolean` en lecture/écriture facultative. `true` si un en-tête de contrôle de cache défini sur Privé est envoyé par défaut ; sinon, `false`. Si `true`, la mise en cache côté client est désactivée. Par défaut, il s’agit de `true`. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`ShutdownTimeout`	Une valeur de lecture/écriture `datetime` facultative qui spécifie la durée d’arrêt d’un processus de travail. La valeur par défaut est de 1 minute, 30 secondes. À l’expiration du délai, ASP.NET ferme le processus de travail. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.
`UseFullyQualifiedRedirectUrl`	Une valeur `boolean` en lecture/écriture facultative. `true` si les redirections côté client sont complètes ; sinon, `false`. Par défaut, il s’agit de `false`. Pour qualifier entièrement les redirections côté client, utilisez le format `http://server/path`. Ce format est requis pour certains contrôles mobiles. Si `true`, toutes les redirections qui ne sont pas complètes sont automatiquement converties en format complet. Si `false`, les redirections relatives sont envoyées au client. Remarque : si `false`, certains navigateurs peuvent rencontrer des problèmes lors du chargement de pages qui se trouvent dans des sessions sans cookie.
`WaitChangeNotification`	Une valeur de lecture/écriture `sint32` facultative qui spécifie le temps, en secondes, pendant lequel il faut attendre une autre notification de changement de fichier avant que le domaine d’application ne redémarre. La valeur par défaut est 0. Définissez cet attribut sur un nombre supérieur à la durée entre les mises à jour de deux notifications de modification de copie de fichier. Les notifications de modification de fichier sont combinées en fonction de la valeur de cette propriété et de la propriété `MaxWaitChangeNotification`. Remarque : cette propriété est nouvelle dans .NET Framework 2.0.

Sous-classes

Cette classe ne contient aucune sous-classe.

Hiérarchie d'héritage

ConfigurationSection

HttpRuntimeSection

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

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

Partager via