<httpWebRequest>, élément (paramètres réseau)

Article
05/09/2023

Personnalise les paramètres de requête web.

<configuration>
  <system.net>
    <settings>
      <httpWebRequest>

Syntaxe

<httpWebRequest  
  maximumResponseHeadersLength="size"  
  maximumErrorResponseLength="size"  
  maximumUnauthorizedUploadLength="size"  
  useUnsafeHeaderParsing="true|false"  
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`maximumResponseHeadersLength`	Spécifie la longueur maximale d’un en-tête de réponse, en kilo-octets. La valeur par défaut est 64. La valeur -1 indique qu’aucune limite de taille n’est imposée aux en-têtes de réponse.
`maximumErrorResponseLength`	Spécifie la longueur maximale d’une réponse d’erreur, en kilo-octets. La valeur par défaut est 64. La valeur -1 indique qu'aucune limite de taille n’est imposée dans la réponse d’erreur.
`maximumUnauthorizedUploadLength`	Spécifie la longueur maximale d'un transfert en réponse à un code d'erreur non autorisé, en octets. La valeur par défaut est -1. Une valeur de -1 indique qu'aucune limite de taille n'est imposée au transfert.
`useUnsafeHeaderParsing`	Spécifie si l’analyse d’en-tête non sécurisée est activée. La valeur par défaut est `false`.

Éléments enfants

Aucune.

Éléments parents

Element	Description
settings	Configure les options réseau de base pour l’espace de noms System.Net.

Notes

Par défaut, .NET Framework applique strictement RFC 2616 pour l’analyse d’URI. Certaines réponses de serveur peuvent inclure des caractères de contrôle dans des champs interdits, ce qui entraîne la levée d’une exception WebException par la méthode HttpWebRequest.GetResponse(). Si useUnsafeHeaderParsing est défini sur true, HttpWebRequest.GetResponse() ne lève pas d’exception dans ce cas ; toutefois, votre application est vulnérable à plusieurs formes d’attaques d’analyse d’URI. La meilleure solution consiste à modifier le serveur afin que la réponse n’inclue pas de caractères de contrôle.

Fichiers de configuration

Cet élément peut être défini dans le fichier de configuration de l'application ou dans le fichier de configuration de l'ordinateur (Machine.config).

Exemple

L’exemple suivant montre comment spécifier une longueur d’en-tête maximale supérieure à la normale.

<configuration>  
  <system.net>  
    <settings>  
      <httpWebRequest  
        maximumResponseHeadersLength="128"  
      />  
    </settings>  
  </system.net>  
</configuration>

Partager via