Partager via

<httpRuntime>, élément

  • Article

Configure les paramètres runtime HTTP ASP.NET. Cette section peut être déclarée aux niveaux de l'ordinateur, du site, de l'application et du sous-répertoire.

<configuration>
   <system.web>
      <httpRuntime>

<httpRuntime useFullyQualifiedRedirectUrl="true|false"             maxRequestLength="size in kbytes"             executionTimeout="seconds"             minFreeThreads="number of threads"             minFreeLocalRequestFreeThreads="number of threads"             appRequestQueueLimit="number of requests"             versionHeader="version string"/>

Attributs facultatifs

Attribut Option Description
appRequestQueueLimit     Nombre maximal de demandes que ASP.NET placera en file d'attente pour l'application. Lorsqu'il n'y a pas suffisamment de threads disponibles pour traiter une demande, les demandes sont placées dans une file d'attente. Les demandes entrantes seront rejetées avec une erreur « 503 - Serveur encombré » lorsque la file dépassera la limite spécifiée dans ce paramètre.
executionTimeout     Indique le nombre maximal de secondes pendant lesquelles une demande peut s'exécuter avant d'être automatiquement arrêtée par ASP.NET.
enable Spécifie si le domaine d'application est activé au niveau du nœud actuel et du nœud enfant. La valeur par défaut est true.
    true Spécifie que le domaine d'application est activé.
    false Spécifie que le domaine d'application est désactivé. L'application n'est pas chargée en mémoire et toute demande de client entraîne une erreur 404.
idleTimeOut     Spécifie la durée d'inactivité du domaine d'application avant sa fermeture. La valeur par défaut est 20 minutes.
enableKernelModeCache   Spécifie si la mise en cache de sortie est activée. Pour l'instant, cet attribut n'est approprié que lorsque IIS version 6.0 ou ultérieure est installée. La configuration de la mise en cache de sortie et le type de demande déterminent si un contenu peut être mis en cache.

Pour mettre une réponse en cache, les critères suivants doivent être 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 posséder une stratégie d'expiration de sorte que le noyau sache quand la supprimer.
  • La mise en cache ne peut pas posséder de paramètres ni d'en-têtes de variables.
  • La demande ne doit pas nécessiter d'authentification.
  true Spécifie que la mise en cache est activée.
  false Spécifie que la mise en cache est désactivée.
maxRequestLength     Indique la taille maximale prise en charge pour le transfert de fichiers par ASP.NET. Cette limite peut être utilisée pour éviter des attaques de refus de service provoquées par des utilisateurs envoyant des fichiers volumineux au serveur. La taille spécifiée est en kilo-octets. La valeur par défaut est 4096 Ko (4 Mo).
minFreeLocalRequestFreeThreads     Nombre minimal de threads que ASP.NET garde disponibles pour l'exécution de nouvelles demandes locales. Ce nombre de threads est réservé aux demandes émanant de l'hôte local, au cas où certaines demandes enverraient des demandes enfants à l'hôte local au cours de leur traitement. Cela permet d'éviter les blocages dus à des entrées récursives sur le serveur Web.
minFreeThreads     Nombre minimal de threads disponibles pour l'exécution de nouvelles demandes. ASP.NET conserve ces threads disponibles pour les demandes dont le traitement nécessite des threads supplémentaires.
useFullyQualifiedRedirectUrl     Indique si les redirections côté client sont qualifiées complètes (sous la forme {LIENHYPERTEXTE "http://serveur/chemin" }, requise pour certains contrôles mobiles) ou relatives.
    true Spécifie que les redirections côté client doivent être envoyées qualifiées complètes. Ce résultat est obtenu par la conversion automatique de toutes les redirections relatives en redirections qualifiées complètes.
    false Spécifie que les redirections côté client ne nécessitent pas de conversion automatique en redirections qualifiées complètes. False est la valeur par défaut.
versionHeader     Spécifie la valeur d'un en-tête de version envoyé par ASP.NET à chaque réponse. Cet attribut est utilisé par Microsoft Visual Studio .NET pour déterminer quelle version de ASP.NET est utilisée. N'est pas nécessaire aux sites de production et peut être désactivé soit en supprimant l'attribut de Web.config ou Machine.config, soit en affectant une chaîne vide à l'attribut (versionHeader="").

Exemple

L'exemple suivant spécifie les paramètres runtime HTTP pour une application ASP.NET.

<configuration>
   <system.web>
      <httpRuntime maxRequestLength="4000"
         useFullyQualifiedRedirectUrl="true"
         executionTimeout="45"
         versionHeader="1.1.4128"/>
   </system.web>
</configuration>

Configuration requise

Contenu dans : <system.web>

Plate-forme Web : IIS 5.0, IIS 5.1, IIS 6.0

Fichier de configuration : Machine.config, Web.config

Gestionnaire de sections de configuration : System.Web.Configuration.HttpRuntimeConfigurationHandler

Voir aussi

Configuration ASP.NET | Schéma des paramètres ASP.NET | Mise en cache de pages ASP.NET