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

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

Элемент <configuration>
  Элемент <system.Net> (параметры сети)
    Элемент <settings> (параметры сети)
      Элемент <httpWebRequest> (параметры сети)

<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

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