HttpWebRequest Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет связанную с HTTP реализацию класса WebRequest.
public ref class HttpWebRequest : System::Net::WebRequest
public ref class HttpWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable
public class HttpWebRequest : System.Net.WebRequest
public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable
type HttpWebRequest = class
inherit WebRequest
type HttpWebRequest = class
inherit WebRequest
interface ISerializable
[<System.Serializable>]
type HttpWebRequest = class
inherit WebRequest
interface ISerializable
Public Class HttpWebRequest
Inherits WebRequest
Public Class HttpWebRequest
Inherits WebRequest
Implements ISerializable
- Наследование
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере кода создается универсальный HttpWebRequest код ресурса (URI http://www.contoso.com/
).
HttpWebRequest^ myReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com/" ));
HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");
Dim myReq As HttpWebRequest = _
WebRequest.Create("http://www.contoso.com/")
Комментарии
Важно!
Мы не рекомендуем использовать HttpWebRequest
для разработки новых версий. Вместо этого используйте System.Net.Http.HttpClient класс.
Класс HttpWebRequest обеспечивает поддержку свойств и методов, определенных в WebRequest и для дополнительных свойств и методов, которые позволяют пользователю взаимодействовать напрямую с серверами с помощью HTTP.
Не используйте HttpWebRequest конструктор. Используйте метод для инициализации WebRequest.Create новых HttpWebRequest объектов. Если схема для универсального кода ресурса (URI) имеет значение http://
или https://
Create возвращает HttpWebRequest объект.
Метод GetResponse выполняет синхронный запрос к ресурсу, указанному в свойстве RequestUri , и возвращает объект HttpWebResponse ответа, содержащий объект ответа. Данные ответа можно получить с помощью потока, возвращенного GetResponseStream. Если объект ответа или поток ответа закрыт, остальные данные будут отключены. Оставшиеся данные будут удалены, и сокет будет повторно использоваться для последующих запросов при закрытии объекта ответа или потока, если хранятся следующие условия: это запрос на поддержание активности или конвейер, получение только небольшого объема данных или получение оставшихся данных в течение небольшого интервала времени. Если ни одно из упомянутых условий не задерживается или превышено время очистки, сокет будет закрыт. Для поддержания активности или конвейерных подключений настоятельно рекомендуется, чтобы приложение считывало потоки до EOF. Это гарантирует повторное использование сокета для последующих запросов, что приведет к повышению производительности и уменьшению используемых ресурсов.
Если вы хотите отправить данные в ресурс, GetRequestStream метод возвращает объект, используемый Stream для отправки данных. Методы BeginGetRequestStream предоставляют EndGetRequestStream асинхронный доступ к потоку данных отправки.
Для проверки подлинности клиента с HttpWebRequestпомощью сертификата клиента необходимо установить в хранилище моего сертификата текущего пользователя.
Класс HttpWebRequest создает исключение WebException при возникновении ошибок при доступе к ресурсу. Свойство WebException.Status содержит WebExceptionStatus значение, указывающее источник ошибки. В WebException.Status этом WebExceptionStatus.ProtocolErrorResponse случае свойство содержит полученное HttpWebResponse от ресурса значение.
HttpWebRequest предоставляет общие значения заголовков HTTP, отправляемые в интернет-ресурс как свойства, заданные методами или заданные системой; В следующей таблице содержится полный список. Другие заголовки в свойстве Headers можно задать в виде пар "имя-значение". Обратите внимание, что серверы и кэши могут изменять или добавлять заголовки во время запроса.
В следующей таблице перечислены заголовки HTTP, заданные свойствами или методами или системой.
Header | Задать по |
---|---|
Accept |
Задано свойством Accept . |
Connection |
Задано свойством Connection , KeepAlive свойством. |
Content-Length |
Задано свойством ContentLength . |
Content-Type |
Задано свойством ContentType . |
Expect |
Задано свойством Expect . |
Date |
Устанавливается системой на текущую дату. |
Host |
Установите в системе текущие сведения о узле. |
If-Modified-Since |
Задано свойством IfModifiedSince . |
Range |
Задается методом AddRange . |
Referer |
Задано свойством Referer . |
Transfer-Encoding |
Задано свойством TransferEncoding ( SendChunked свойство должно быть true ). |
User-Agent |
Задано свойством UserAgent . |
Примечание
HttpWebRequest регистрируется автоматически. Перед использованием универсальных кодов ресурса (URIhttps://``http://
) не требуется вызывать RegisterPrefix метод для регистрацииSystem.Net.HttpWebRequest.
Локальный компьютер или файл конфигурации приложения может указать, что используется прокси-сервер по умолчанию. Proxy Если свойство указано, параметры прокси-сервера из Proxy свойства переопределяют локальный компьютер или файл конфигурации приложения, а HttpWebRequest экземпляр будет использовать указанные параметры прокси-сервера. Если прокси-сервер не указан в файле конфигурации и Proxy свойство не указано, класс использует параметры прокси-сервера, HttpWebRequest унаследованные от Internet Explorer на локальном компьютере. Если в Internet Explorer нет параметров прокси-сервера, запрос отправляется непосредственно на сервер.
Класс HttpWebRequest анализирует список обхода прокси-сервера с подстановочными знаками, унаследованными от Internet Explorer, не так, как список обходов анализируется непосредственно Internet Explorer. Например, HttpWebRequest класс анализирует список обходов nt*из Internet Explorer как регулярное выражение nt.$. Это отличается от собственного поведения Internet Explorer. Таким образом, URL-адрес "http://intxxxxx
" будет обходить прокси-сервер с помощью HttpWebRequest класса, но не будет обходить прокси-сервер с помощью Internet Explorer.
Примечание
Платформа кэширует сеансы SSL по мере их создания и пытается повторно использовать кэшированный сеанс для нового запроса, если это возможно. При попытке повторного использования сеанса SSL платформа использует первый элемент ClientCertificates (если таковой имеется) или пытается повторно использовать анонимные сеансы, если ClientCertificates он пуст.
Примечание
По соображениям безопасности файлы cookie отключены по умолчанию. Если вы хотите использовать файлы cookie, используйте CookieContainer свойство для включения файлов cookie.
В платформа .NET Framework 4.6 есть новая функция безопасности, которая блокирует небезопасные алгоритмы шифра и хэширования для подключений. Приложения, использующие TLS/SSL с помощью ТАКИх API, как HttpClient, HttpWebRequest, FTPClient, SmtpClient, SslStream и т. д. и предназначенные для платформа .NET Framework 4.6 по умолчанию получают более безопасное поведение.
Разработчики могут отказаться от этого поведения, чтобы обеспечить взаимодействие с существующими службами SSL3 или TLS w/ RC4. В этой статье объясняется, как изменить код таким образом, чтобы новое поведение было отключено.
Конструкторы
HttpWebRequest() |
Является устаревшей.
Является устаревшей.
Инициализирует новый экземпляр класса HttpWebRequest. Этот конструктор является устаревшим. |
HttpWebRequest(SerializationInfo, StreamingContext) |
Является устаревшей.
Является устаревшей.
Является устаревшей.
Является устаревшей.
Является устаревшей.
Инициализирует новый экземпляр класса HttpWebRequest на основе указанных экземпляров классов SerializationInfo и StreamingContext. Этот конструктор является устаревшим. |
HttpWebRequest(Uri) |
Свойства
Accept |
Возвращает или задает значение HTTP-заголовка |
Address |
Возвращает код URI интернет-ресурса, который фактически отвечает на запрос. |
AllowAutoRedirect |
Возвращает или задает значение, которое указывает, должен ли запрос следовать ответам переадресации. |
AllowReadStreamBuffering |
Возвращает или задает значение, которое указывает, будет ли выполняться буферизация данных, полученных от интернет-ресурса. |
AllowWriteStreamBuffering |
Возвращает или задает значение, которое указывает, будет ли выполняться буферизация данных, отправляемых в интернет-ресурс. |
AuthenticationLevel |
Возвращает или задает значения, указывающие уровень проверки подлинности и олицетворения, используемые для этого запроса. (Унаследовано от WebRequest) |
AutomaticDecompression |
Возвращает или задает тип используемой распаковки. |
CachePolicy |
Возвращает или задает политику кэширования для этого запроса. (Унаследовано от WebRequest) |
ClientCertificates |
Возвращает или задает коллекцию сертификатов безопасности, связанных с данным запросом. |
Connection |
Возвращает или задает значение HTTP-заголовка |
ConnectionGroupName |
Возвращает или задает имя группы подключения для запроса. |
ConnectionGroupName |
Если переопределено во вложенном классе, возвращает или задает имя группы подключения для данного запроса. (Унаследовано от WebRequest) |
ContentLength |
Возвращает или задает заголовок HTTP |
ContentLength |
При переопределении во вложенный класс возвращает или задает длину содержимого запрошенных к передаче данных. (Унаследовано от WebRequest) |
ContentType |
Возвращает или задает значение HTTP-заголовка |
ContinueDelegate |
Возвращает или задает метод делегата, вызываемый при получении от интернет-ресурса HTTP-ответа 100-continue. |
ContinueTimeout |
Возвращает или задает время ожидания в миллисекундах до получения ответа 100-Continue с сервера. |
CookieContainer |
Возвращает или задает файлы cookie, связанные с запросом. |
CreatorInstance |
Является устаревшей.
Если переопределено в производном классе, получает объект фабрики, производный от класса IWebRequestCreate, который служит для создания объекта WebRequest для создания запроса по указанному универсальному коду ресурса (URI). (Унаследовано от WebRequest) |
Credentials |
Возвращает или задает сведения о проверке подлинности для этого запроса. |
Date |
Получает или задает значение заголовка HTTP |
DefaultCachePolicy |
Возвращает или задает политику кэширования для этого запроса. |
DefaultMaximumErrorResponseLength |
Возвращает или задает наибольшую длину по умолчанию для ответа HTTP об ошибке. |
DefaultMaximumResponseHeadersLength |
Возвращает или задает значение по умолчанию для свойства MaximumResponseHeadersLength. |
Expect |
Возвращает или задает значение HTTP-заголовка |
HaveResponse |
Возвращает значение, показывающее, был ли получен ответ от интернет-ресурса. |
Headers |
Указывает коллекцию пар "имя-значение", из которых создаются заголовки HTTP. |
Host |
Получает или задает значение заголовка Host для использования в HTTP-запросе независимо от URI запроса. |
IfModifiedSince |
Возвращает или задает значение HTTP-заголовка |
ImpersonationLevel |
Возвращает или задает уровень олицетворения для текущего запроса. (Унаследовано от WebRequest) |
KeepAlive |
Возвращает или задает значение, указывающее, необходимо ли устанавливать постоянное подключение к интернет-ресурсу. |
MaximumAutomaticRedirections |
Возвращает или задает максимальное количество переадресаций, выполняемых запросом. |
MaximumResponseHeadersLength |
Возвращает или задает максимальную допустимую длину заголовков ответов. |
MediaType |
Возвращает или задает формат носителя запроса. |
Method |
Возвращает или задает метод для запроса. |
Pipelined |
Возвращает или задает значение, указывающее, выполняется ли конвейерная передача запроса в интернет-ресурс. |
PreAuthenticate |
Возвращает или задает значение, указывающее, следует ли отправлять заголовок авторизации вместе с запросом. |
PreAuthenticate |
При переопределении во вложенном классе показывает, необходима ли предварительная проверка подлинности данного запроса. (Унаследовано от WebRequest) |
ProtocolVersion |
Возвращает или задает версию HTTP-протокола, используемую для запроса. |
Proxy |
Возвращает или задает сведения о прокси-сервере для запроса. |
Proxy |
Если переопределено во вложенном классе, возвращает или задает сетевой прокси-сервер, используемый для доступа к данному интернет-ресурсу. (Унаследовано от WebRequest) |
ReadWriteTimeout |
Возвращает или задает время ожидания в миллисекундах при записи в поток или при чтении из него. |
Referer |
Возвращает или задает значение HTTP-заголовка |
RequestUri |
Возвращает исходный код URI запроса. |
SendChunked |
Возвращает или задает значение, которое указывает, будут ли отправляться данные в интернет-ресурс в виде сегментов. |
ServerCertificateValidationCallback |
Возвращает или задает функцию обратного вызова для проверки сертификата сервера. |
ServicePoint |
Возвращает точку обслуживания, используемую для запроса. |
SupportsCookieContainer |
Получает значение, которое указывает, поддерживает ли запрос CookieContainer. |
Timeout |
Возвращает или задает значение времени ожидания в миллисекундах для методов GetResponse() и GetRequestStream(). |
Timeout |
Возвращает или задает промежуток времени в миллисекундах до истечения срока действия запроса. (Унаследовано от WebRequest) |
TransferEncoding |
Возвращает или задает значение HTTP-заголовка |
UnsafeAuthenticatedConnectionSharing |
Возвращает или задает значение, указывающее, будет ли разрешено совместное использование высокоскоростного подключения с проверкой подлинности NTLM. |
UseDefaultCredentials |
Возвращает или задает значение Boolean, которое управляет отправкой учетных данных по умолчанию вместе с запросами. |
UseDefaultCredentials |
Если переопределено во вложенном классе, возвращает или задает значение Boolean, с помощью которого определяется, следует ли отправлять учетные данные DefaultCredentials вместе с запросами. (Унаследовано от WebRequest) |
UserAgent |
Возвращает или задает значение HTTP-заголовка |
Методы
Abort() |
Отменяет запрос к интернет-ресурсу. |
AddRange(Int32) |
Добавляет в запрос заголовок диапазона байтов для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных. |
AddRange(Int32, Int32) |
Добавляет в запрос заголовок диапазона байтов для заданного диапазона. |
AddRange(Int64) |
Добавляет в запрос заголовок диапазона байтов для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных. |
AddRange(Int64, Int64) |
Добавляет в запрос заголовок диапазона байтов для заданного диапазона. |
AddRange(String, Int32) |
Добавляет в запрос заголовок Range для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных. |
AddRange(String, Int32, Int32) |
Добавляет в запрос заголовок диапазона для заданного диапазона. |
AddRange(String, Int64) |
Добавляет в запрос заголовок Range для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных. |
AddRange(String, Int64, Int64) |
Добавляет в запрос заголовок диапазона для заданного диапазона. |
BeginGetRequestStream(AsyncCallback, Object) |
Начинает асинхронный запрос объекта Stream, используемого для записи данных. |
BeginGetResponse(AsyncCallback, Object) |
Начинает асинхронный запрос интернет-ресурса. |
CreateObjRef(Type) |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
EndGetRequestStream(IAsyncResult) |
Завершает асинхронный запрос объекта Stream, используемого для записи данных. |
EndGetRequestStream(IAsyncResult, TransportContext) |
Завершает асинхронный запрос объекта Stream, используемого для записи данных, и выводит объект TransportContext, связанный с потоком. |
EndGetResponse(IAsyncResult) |
Завершает асинхронный запрос интернет-ресурса. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Возвращает хэш-значение для экземпляра WebRequest. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetLifetimeService() |
Является устаревшей.
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
GetObjectData(SerializationInfo, StreamingContext) |
Является устаревшей.
Является устаревшей.
Является устаревшей.
Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта. |
GetObjectData(SerializationInfo, StreamingContext) |
Является устаревшей.
Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта. (Унаследовано от WebRequest) |
GetRequestStream() |
Получает объект Stream, используемый для записи данных запроса. |
GetRequestStream() |
Если переопределено в производном классе, возвращает Stream для записи данных в этот интернет-ресурс. (Унаследовано от WebRequest) |
GetRequestStream(TransportContext) |
Получает объект Stream, используемый для записи данных запроса, и выводит объект TransportContext, связанный с потоком. |
GetRequestStreamAsync() |
Если переопределено во вложенном классе, возвращает Stream для записи данных в интернет-ресурс в ходе асинхронной операции. (Унаследовано от WebRequest) |
GetResponse() |
Возвращает ответ от интернет-ресурса. |
GetResponse() |
При переопределении во вложенном классе возвращает ответ на интернет-запрос. (Унаследовано от WebRequest) |
GetResponseAsync() |
При переопределении во вложенном классе возвращает ответ на интернет-запрос в виде асинхронной операции. (Унаследовано от WebRequest) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
InitializeLifetimeService() |
Является устаревшей.
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
MemberwiseClone(Boolean) |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Является устаревшей.
Является устаревшей.
Является устаревшей.
Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта. |