HttpWebResponse Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет реализацию WebResponse класса, зависяющего от HTTP.
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 =
(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.Close и HttpWebResponse.Close, но делать это не приводит к ошибке.
Общие сведения заголовка, возвращаемые из ресурса Интернета, предоставляются как свойства класса. Полный список см. в следующей таблице. Другие заголовки можно считывать из Headers свойства в виде пар "имя-значение".
В следующей таблице показаны общие заголовки HTTP, доступные с помощью свойств HttpWebResponse класса.
| Header | Недвижимость |
|---|---|
| Кодировка содержимого (Content-Encoding) | ContentEncoding |
| Длина содержимого | ContentLength |
| Тип содержимого | ContentType |
| Дата последнего изменения | LastModified |
| Сервер | Server |
Содержимое ответа из ресурса Интернета возвращается в виде Stream вызова GetResponseStream метода.
Конструкторы
| Имя | Описание |
|---|---|
| HttpWebResponse() |
Устаревшие..
Устаревшие..
Устаревшие..
Устаревшие..
Инициализирует новый экземпляр класса HttpWebResponse. |
| HttpWebResponse(SerializationInfo, StreamingContext) |
Устаревшие..
Устаревшие..
Устаревшие..
Инициализирует новый экземпляр HttpWebResponse класса из указанных SerializationInfo и StreamingContext экземпляров. |
Свойства
| Имя | Описание |
|---|---|
| CharacterSet |
Возвращает набор символов ответа. |
| ContentEncoding |
Возвращает метод, используемый для кодирования текста ответа. |
| ContentLength |
Возвращает длину содержимого, возвращаемого запросом. |
| ContentType |
Возвращает тип контента ответа. |
| Cookies |
Возвращает или задает файлы cookie, связанные с этим ответом. |
| Headers |
Возвращает заголовки, связанные с этим ответом с сервера. |
| IsFromCache |
Boolean Возвращает значение, указывающее, получен ли этот ответ из кэша. (Унаследовано от WebResponse) |
| IsMutuallyAuthenticated |
Boolean Возвращает значение, указывающее, прошли ли проверка подлинности как клиент, так и сервер. |
| LastModified |
Получает последнюю дату и время изменения содержимого ответа. |
| Method |
Возвращает метод, используемый для возврата ответа. |
| ProtocolVersion |
Возвращает версию протокола HTTP, который используется в ответе. |
| ResponseUri |
Возвращает универсальный код ресурса Интернета, который ответил на запрос. |
| Server |
Возвращает имя сервера, отправляющего ответ. |
| StatusCode |
Возвращает состояние ответа. |
| StatusDescription |
Возвращает описание состояния, возвращенное ответом. |
| SupportsHeaders |
Возвращает значение, указывающее, поддерживаются ли заголовки. |
Методы
| Имя | Описание |
|---|---|
| Close() |
Закрывает поток отклика. |
| CreateObjRef(Type) |
Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает неуправляемые ресурсы, используемые WebResponse объектом. (Унаследовано от WebResponse) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые HttpWebResponseи при необходимости удаляет управляемые ресурсы. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Возвращает хэш-значение для экземпляра HttpWebResponse . |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| GetObjectData(SerializationInfo, StreamingContext) |
Устаревшие..
Устаревшие..
Устаревшие..
Заполняет SerializationInfo данные, необходимые для сериализации целевого объекта. |
| 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 объект. |