<Элемент httpWebRequest> (параметры сети)

Статья
04/11/2023

Настраивает параметры веб-запроса.

<Конфигурации>
  <system.net>
    <Параметры>
      <httpWebRequest>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Attribute	Описание
`maximumResponseHeadersLength`	Указывает максимальную длину заголовка ответа в килобайтах. Значение по умолчанию — 64. Значение -1 указывает, что для заголовков ответов не будет накладываться ограничение на размер.
`maximumErrorResponseLength`	Указывает максимальную длину ответа об ошибке в килобайтах. Значение по умолчанию — 64. Значение -1 указывает, что для ответа об ошибке не будет накладываться ограничение на размер.
`maximumUnauthorizedUploadLength`	Указывает максимальную длину отправки в ответ на несанкционированный код ошибки в байтах. Значение по умолчанию — -1. Значение -1 указывает на отсутствие ограничений.
`useUnsafeHeaderParsing`	Указывает, включен ли небезопасный анализ заголовков. Значение по умолчанию — `false`.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент	Описание
параметры	Настраивает основные параметры сети для пространства имен System.Net.

По умолчанию платформа .NET Framework строго применяет RFC 2616 для синтаксического анализа URI. Некоторые ответы сервера могут содержать управляющие символы в запрещенных полях, что приведет к тому HttpWebRequest.GetResponse() , что метод вызовет исключение WebException. Если для параметра useUnsafeHeaderParsing задано значение true, HttpWebRequest.GetResponse() в этом случае не будет вызываться исключение. Однако приложение будет уязвимо для нескольких форм атак анализа URI. Лучшим решением является изменение сервера таким образом, чтобы ответ не включал управляющие символы.

Файлы конфигурации

Этот элемент может использоваться в файле конфигурации приложения или в файле конфигурации компьютера (Machine.config).

Пример

В следующем примере показано, как указать максимальную длину заголовка, превышающую обычную.

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

Поделиться через