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

Статья
08/11/2011

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

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

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

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

Атрибуты

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

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

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

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

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

Заметки

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

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

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

Пример

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

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

См. также

Ссылки

Схема параметров сети

MaximumResponseHeadersLength

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