Compartilhar via


HttpWebResponse Classe

Definição

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

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 =
(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 método ou o Stream.CloseHttpWebResponse.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.

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
Tamanho do conteúdo ContentLength
Tipo de conteúdo ContentType
Última Modificação LastModified
Servidor Server

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

Construtores

Nome Description
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 das HttpWebResponse instâncias e StreamingContext especificadasSerializationInfo.

Propriedades

Nome Description
CharacterSet

Obtém o conjunto de caracteres da resposta.

ContentEncoding

Obtém o método usado para codificar o corpo da resposta.

ContentLength

Obtém o comprimento 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 associados a essa resposta do servidor.

IsFromCache

Obtém um Boolean valor que indica se essa resposta foi obtida do cache.

(Herdado de WebResponse)
IsMutuallyAuthenticated

Obtém um Boolean valor que indica se o cliente e o servidor foram autenticados.

LastModified

Obtém a última data e hora em que o conteúdo da resposta foi modificado.

Method

Obtém o método 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 de status retornada com a resposta.

SupportsHeaders

Obtém um valor que indica se há suporte para cabeçalhos.

Métodos

Nome Description
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 WebResponse objeto.

(Herdado de WebResponse)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo HttpWebResponsee, opcionalmente, descarta os recursos gerenciados.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

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

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 tempo de vida para essa 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.

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 dessa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
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 pelo WebResponse.

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

Serializa essa instância no objeto especificado SerializationInfo .

Aplica-se a

Confira também