HttpWebResponse Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет связанную с HTTP реализацию класса WebResponse.
public ref class HttpWebResponse : System::Net::WebResponse
public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable
public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
public class HttpWebResponse : System.Net.WebResponse
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
inherit WebResponse
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
interface IDisposable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
- Наследование
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере возвращается HttpWebResponse из HttpWebRequest.
HttpWebRequest^ HttpWReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com" ));
HttpWebResponse^ HttpWResp = dynamic_cast<HttpWebResponse^>(HttpWReq->GetResponse());
// Insert code that uses the response object.
HttpWResp->Close();
HttpWebRequest HttpWReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object.
HttpWResp.Close();
Dim HttpWReq As HttpWebRequest = _
CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
Dim HttpWResp As HttpWebResponse = _
CType(HttpWReq.GetResponse(), HttpWebResponse)
' Insert code that uses the response object.
HttpWResp.Close()
Комментарии
Этот класс содержит поддержку использования свойств и методов WebResponse класса , относящихся к HTTP. Класс HttpWebResponse используется для создания автономных клиентских приложений HTTP, которые отправляют HTTP-запросы и получают HTTP-ответы.
Примечание
Не путайте HttpWebResponse с классом HttpResponse , который используется в приложениях ASP.NET, методы и свойства которого предоставляются через ASP. Встроенный Response
объект NET.
Никогда не следует напрямую создавать экземпляр HttpWebResponse класса . Вместо этого используйте экземпляр , возвращенный вызовом HttpWebRequest.GetResponse. Необходимо вызвать метод Stream.Close или , HttpWebResponse.Close чтобы закрыть ответ и освободить подключение для повторного использования. Нет необходимости вызывать и Stream.CloseHttpWebResponse.Close, но это не приводит к ошибке.
Общие сведения о заголовке, возвращаемые из интернет-ресурса, предоставляются как свойства класса . Полный список см. в следующей таблице. Другие заголовки можно считывать из свойства в Headers виде пар "имя-значение".
В следующей таблице показаны распространенные заголовки HTTP, доступные через свойства HttpWebResponse класса .
Header | Свойство. |
---|---|
Content-Encoding | ContentEncoding |
Content-Length | ContentLength |
Content-Type | ContentType |
Last-Modified | LastModified |
Сервер | Server |
Содержимое ответа от интернет-ресурса возвращается в виде Stream метода GetResponseStream .
Конструкторы
HttpWebResponse() |
Устаревшие..
Устаревшие..
Устаревшие..
Устаревшие..
Инициализирует новый экземпляр класса HttpWebResponse. |
HttpWebResponse(SerializationInfo, StreamingContext) |
Устаревшие..
Устаревшие..
Устаревшие..
Инициализирует новый экземпляр класса HttpWebResponse из указанных экземпляров SerializationInfo и StreamingContext. |
Свойства
CharacterSet |
Возвращает кодировку ответа. |
ContentEncoding |
Возвращает метод, используемый для кодирования основного текста ответа. |
ContentLength |
Возвращает длину содержимого, возвращаемого запросом. |
ContentType |
Возвращает тип содержимого ответа. |
Cookies |
Возвращает или задает файлы cookie, связанные с этим ответом. |
Headers |
Получает с сервера заголовки, связанные с данным ответом. |
IsFromCache |
Возвращает значение Boolean, указывающее, был ли этот ответ получен из кэша. (Унаследовано от WebResponse) |
IsMutuallyAuthenticated |
Возвращает значение Boolean, которое указывает, прошли ли проверку подлинности как клиент, так и сервер. |
IsMutuallyAuthenticated |
Возвращает значение Boolean, указывающее, была ли выполнена взаимная проверка подлинности. (Унаследовано от WebResponse) |
LastModified |
Возвращает дату и время последнего изменения содержимого ответа. |
Method |
Возвращает метод, используемый для возврата ответа. |
ProtocolVersion |
Возвращает версию протокола HTTP, используемую в ответе. |
ResponseUri |
Возвращает URI Интернет-ресурса, ответившего на запрос. |
Server |
Возвращает имя сервера, отправившего ответ. |
StatusCode |
Возвращает состояние ответа. |
StatusDescription |
Получает описание состояния, возвращаемого с ответом. |
SupportsHeaders |
Возвращает значение, указывающее, поддерживаются ли заголовки. |
SupportsHeaders |
Возвращает значение, указывающее, поддерживаются ли заголовки. (Унаследовано от WebResponse) |
Методы
Close() |
Закрывает поток ответа. |
Close() |
При переопределении во вложенном классе закрывает поток ответа. (Унаследовано от WebResponse) |
CreateObjRef(Type) |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
Dispose() |
Высвобождает неуправляемые ресурсы, используемые в объекте WebResponse. (Унаследовано от WebResponse) |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом HttpWebResponse, и при необходимости освобождает также управляемые ресурсы. |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом WebResponse, и опционально — управляемые ресурсы. (Унаследовано от WebResponse) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Возвращает хэш-значение для экземпляра HttpWebResponse. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetLifetimeService() |
Устаревшие..
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
GetObjectData(SerializationInfo, StreamingContext) |
Устаревшие..
Устаревшие..
Устаревшие..
Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта. |
GetObjectData(SerializationInfo, StreamingContext) |
Устаревшие..
Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта. (Унаследовано от WebResponse) |
GetResponseHeader(String) |
Получает содержимое заголовка, возвращенного с ответом. |
GetResponseStream() |
Возвращает поток, используемый для чтения основного текста ответа с сервера. |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
MemberwiseClone(Boolean) |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
IDisposable.Dispose() |
Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Освобождает все ресурсы, занятые модулем HttpWebResponse. |
IDisposable.Dispose() |
При переопределении в производном классе освобождает все ресурсы, используемые объектом WebResponse. (Унаследовано от WebResponse) |
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Устаревшие..
Устаревшие..
Устаревшие..
Сериализует этот экземпляр в указанный объект SerializationInfo. |