HttpWebResponse Classe

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebResponse.cs

Fornece uma implementação específica de HTTP da classe WebResponse.

public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable

public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable

type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable

Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable

Herança

Object

MarshalByRefObject

WebResponse

HttpWebResponse

Implementações

ISerializable

Exemplos

O exemplo a seguir retorna um HttpWebResponse de um 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()

Comentários

Essa classe contém suporte para usos específicos de HTTP das propriedades e métodos da WebResponse classe . A HttpWebResponse classe é usada para criar aplicativos cliente autônomos HTTP que enviam solicitações HTTP e recebem respostas HTTP.

Observação

Não confunda HttpWebResponse com a HttpResponse classe usada em aplicativos ASP.NET e cujos métodos e propriedades são expostos por meio do ASP. Objeto intrínseco Response do NET.

Você nunca deve criar diretamente uma instância da HttpWebResponse classe . Em vez disso, use a instância retornada por uma chamada para HttpWebRequest.GetResponse. Você deve chamar o Stream.Close método ou HttpWebResponse.Close para fechar a resposta e liberar a conexão para reutilização. Não é necessário chamar e Stream.CloseHttpWebResponse.Close, mas fazer isso não causa um erro.

As informações comuns de cabeçalho retornadas do recurso da Internet são expostas como propriedades da classe . Consulte a tabela a seguir para obter uma lista completa. Outros cabeçalhos podem ser lidos da Headers propriedade como pares nome/valor.

A tabela a seguir mostra os cabeçalhos HTTP comuns que estão disponíveis por meio de propriedades da HttpWebResponse classe .

Cabeçalho	Propriedade
Codificação de conteúdo	ContentEncoding
Content-Length	ContentLength
Tipo de conteúdo	ContentType
Last-Modified	LastModified
Servidor	Server

O conteúdo da resposta do recurso da Internet é retornado como um Stream chamando o GetResponseStream método .

Construtores

HttpWebResponse()	Obsoleto. Inicializa uma nova instância da classe HttpWebResponse.
HttpWebResponse(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe HttpWebResponse das instâncias SerializationInfo e StreamingContext especificadas.

Propriedades

CharacterSet	Obtém o conjunto de caracteres da resposta.
ContentEncoding	Obtém o método que é usado para codificar o corpo da resposta.
ContentLength	Obtém o tamanho do conteúdo retornado pela solicitação.
ContentType	Obtém o tipo de conteúdo da resposta.
Cookies	Obtém ou define os cookies associados a essa resposta.
Headers	Obtém os cabeçalhos que estão associados a essa resposta do servidor.
IsFromCache	Obtém um valor Boolean que indica se essa resposta foi obtida do cache. (Herdado de WebResponse)
IsMutuallyAuthenticated	Obtém um valor Boolean que indica se o servidor e o cliente foram ambos autenticados.
LastModified	Obtém a última data e hora em que o conteúdo da resposta foi modificado.
Method	Obtém o método que é usado para retornar a resposta.
ProtocolVersion	Obtém a versão do protocolo HTTP usada na resposta.
ResponseUri	Obtém o URI do recurso da Internet que respondeu à solicitação.
Server	Obtém o nome do servidor que enviou a resposta.
StatusCode	Obtém o status da resposta.
StatusDescription	Obtém a descrição do status retornada com a resposta.
SupportsHeaders	Obtém um valor que indica se os cabeçalhos têm ou não suporte.

Métodos

Close()	Fecha o fluxo de resposta.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera os recursos não gerenciados usados pelo objeto WebResponse. (Herdado de WebResponse)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo HttpWebResponse e, opcionalmente, descarta os recursos gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.
GetResponseHeader(String)	Obtém o conteúdo de um cabeçalho que foi retornado com a resposta.
GetResponseStream()	Obtém o fluxo usado para ler o corpo da resposta do servidor.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obsoleto. Serializa esta instância para o objeto SerializationInfo especificado.

Confira também

• WebResponse