Partilhar via


HttpWebResponse Classe

Definição

Fornece uma implementação específica de HTTP da classe 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
Herança
HttpWebResponse
Herança
Atributos
Implementações

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.
Obsoleto.
Obsoleto.
Obsoleto.

Inicializa uma nova instância da classe HttpWebResponse.

HttpWebResponse(SerializationInfo, StreamingContext)
Obsoleto.
Obsoleto.
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.

IsMutuallyAuthenticated

Obtém um valor Boolean que indica se ocorreu uma autenticação mútua.

(Herdado de WebResponse)
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.

SupportsHeaders

Obtém um valor que indica se os cabeçalhos têm suporte.

(Herdado de WebResponse)

Métodos

Close()

Fecha o fluxo de resposta.

Close()

Quando substituído por uma classe descendente, fecha o fluxo de resposta.

(Herdado de WebResponse)
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.

Dispose(Boolean)

Libera os recursos não gerenciados usados pelo objeto WebResponse e, opcionalmente, libera os recursos gerenciados.

(Herdado de WebResponse)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Retorna um valor de hash para uma instância de HttpWebResponse.

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.
Obsoleto.
Obsoleto.

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.

GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Preenche um SerializationInfo com os dados necessários para serializar o objeto de destino.

(Herdado de WebResponse)
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

IDisposable.Dispose()

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Libera todos os recursos usados pelo HttpWebResponse.

IDisposable.Dispose()

Quando substituído em uma classe derivada, libera todos os recursos usados pela WebResponse.

(Herdado de WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.
Obsoleto.
Obsoleto.

Serializa esta instância para o objeto SerializationInfo especificado.

Aplica-se a

Confira também