HttpWebResponse Classe

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

WebResponse
HttpWebResponse

Herança: Object

MarshalByRefObject

WebResponse
HttpWebResponse

Atributos: SerializableAttribute

Implementações: ISerializable IDisposable

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 objeto intrínseco Response do ASP.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 método ou o Stream.Close HttpWebResponse.Close método para fechar a resposta e liberar a conexão para reutilização. Não é necessário chamar ambos Stream.Close e HttpWebResponse.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. 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)