Описание тега httpwebrequest

HttpWebRequest - это класс для приложений.NET Framework, который предоставляет специфичную для HTTP реализацию класса WebRequest.

В HttpWebRequest class обеспечивает поддержку свойств и методов, определенных в WebRequest, а также дополнительных свойств и методов, которые позволяют пользователю напрямую взаимодействовать с серверами с помощью HTTP.

Не используйте конструктор HttpWebRequest. Используйте метод WebRequest.Create для инициализации новых объектов HttpWebRequest. Если схема для универсального идентификатора ресурса (URI) - http:// или https://, Create возвращает объект HttpWebRequest.

Метод GetResponse выполняет синхронный запрос к ресурсу, указанному в свойстве RequestUri, и возвращает HttpWebResponse, содержащий ответ. Вы можете сделать асинхронный запрос к ресурсу с помощью методов BeginGetResponse и EndGetResponse.

Если вы хотите отправить данные в ресурс, метод GetRequestStream возвращает объект Stream, который будет использоваться для отправки данных. Методы BeginGetRequestStream и EndGetRequestStream обеспечивают асинхронный доступ к потоку отправляемых данных.

Для аутентификации клиента с помощью HttpWebRequest сертификат клиента должен быть установлен в хранилище моих сертификатов текущего пользователя.

Класс HttpWebRequest выдает исключение WebException при возникновении ошибок при доступе к ресурсу. Свойство WebException.Status содержит значение WebExceptionStatus, указывающее на источник ошибки. Когда WebException.Status имеет значение WebExceptionStatus.ProtocolError, свойство Response содержит HttpWebResponse, полученный от ресурса.

HttpWebRequest предоставляет общие значения заголовков HTTP, отправляемые в Интернет-ресурс как свойства, устанавливаемые методами или устанавливаемые системой; следующая таблица содержит полный список. Вы можете установить другие заголовки в свойстве Headers как пары имя / значение. Обратите внимание, что серверы и кеши могут изменять или добавлять заголовки во время запроса.

Вы можете найти документацию по этому классу на MSDN.