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

Article
08/10/2011

Personnalise les paramètres de demande Web.

<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. Une valeur de -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. Une valeur de -1 indique qu'aucune limite de taille n'est imposée à la réponse d'erreur.
maximumUnauthorizedUploadLength	Spécifie la longueur maximale d'un téléchargement 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 des en-têtes non sécurisés est activée. La valeur par défaut est false.

Éléments enfants

Aucun

Éléments parents

Élément	Description
<settings>	Configure les options réseau de base pour l'espace de noms System.Net.

Notes

Par défaut, le .NET Framework applique strictement la norme RFC 2616 pour l'analyse URI. Certaines réponses du serveur peuvent inclure des caractères de contrôle dans les champs interdits ; dans ce cas, la méthode HttpWebRequest.GetResponse() lève une WebException. Si useUnsafeHeaderParsing a la valeur true, HttpWebRequest.GetResponse() ne lève pas d'exception ; toutefois, votre application sera vulnérable à plusieurs formes d'attaques d'analyse URI. La meilleure solution consiste à changer le serveur de sorte que la réponse n'inclue pas de caractères de contrôle.

Fichiers de configuration

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

Exemple

L'exemple de code suivant indique comment spécifier une longueur d'en-tête supérieure à la longueur maximale standard.

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

Voir aussi

Référence

Schéma des paramètres réseau

MaximumResponseHeadersLength

Partager via