HttpWebResponse Classe

Definição

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

public ref class HttpWebResponse : System::Net::WebResponse
public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable
public class HttpWebResponse : System.Net.WebResponse
[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
[<System.Serializable>]
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
    interface IDisposable
[<System.Serializable>]
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable
Herança
HttpWebResponse
Herança
Atributos
Implementações

Exemplos

O exemplo seguinte devolve 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()

Observações

Esta classe contém suporte para usos específicos HTTP das propriedades e métodos da WebResponse classe. A HttpWebResponse classe é usada para construir aplicações cliente HTTP autónomas que enviam pedidos HTTP e recebem respostas HTTP.

Note

Não confunda HttpWebResponse com a classe HttpResponse que é usada em aplicações ASP.NET e cujos métodos e propriedades são expostos através do objeto intrínseco Response de ASP.NET.

Nunca deves criar diretamente uma instância da HttpWebResponse classe. Em vez disso, use a instância devolvida por uma chamada para HttpWebRequest.GetResponse. Deve chamar o Stream.Close ou o HttpWebResponse.Close método para fechar a resposta e libertar a ligação para reutilização. Não é necessário chamar ambos Stream.Close e HttpWebResponse.Close, mas fazê-lo não causa erro.

A informação comum dos cabeçalhos retornada do recurso da Internet é exposta como propriedades da classe. Consulte a tabela seguinte para uma lista completa. Outros cabeçalhos podem ser lidos da Headers propriedade como pares nome/valor.

A tabela seguinte mostra os cabeçalhos HTTP comuns disponíveis através das propriedades da HttpWebResponse classe.

Cabeçalho Property
Codificação de conteúdo ContentEncoding
Tamanho do conteúdo ContentLength
Tipo de Conteúdo ContentType
Última modificação LastModified
Server Server

O conteúdo da resposta do recurso da Internet é devolvido como um Stream ao chamar o GetResponseStream método.

Construtores

Name Description
HttpWebResponse()
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.

Inicializa uma nova instância da HttpWebResponse classe.

HttpWebResponse(SerializationInfo, StreamingContext)
Obsoleto.
Obsoleto.

Inicializa uma nova instância da HttpWebResponse classe a partir das instâncias e StreamingContext especificadasSerializationInfo.

Propriedades

Name Description
CharacterSet

Obtém o conjunto de caracteres da resposta.

ContentEncoding

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

ContentLength

Recebe o comprimento do conteúdo devolvido pelo pedido.

ContentType

Percebe o tipo de conteúdo da resposta.

Cookies

Recebe ou define os cookies associados a esta resposta.

Headers

Recebe os cabeçalhos associados a esta resposta do servidor.

IsFromCache

Obtém um Boolean valor que indica se esta resposta foi obtida a partir da cache.

(Herdado de WebResponse)
IsMutuallyAuthenticated

Recebe um Boolean valor que indica se tanto o cliente como 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 que é usado para devolver 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 ao pedido.

Server

Obtém o nome do servidor que enviou a resposta.

StatusCode

Percebe o estado da resposta.

StatusDescription

Recebe a descrição do estado com a resposta.

SupportsHeaders

Recebe um valor que indica se os cabeçalhos são suportados.

Métodos

Name Description
Close()

Fecha o fluxo de resposta.

CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Liberta os recursos não geridos usados pelo WebResponse objeto.

(Herdado de WebResponse)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo HttpWebResponse, e opcionalmente elimina os recursos geridos.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

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

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Preenche a SerializationInfo com os dados necessários para serializar o objeto alvo.

GetResponseHeader(String)

Recebe o conteúdo de um cabeçalho que foi devolvido com a resposta.

GetResponseStream()

Recebe o stream que é usado para ler o corpo da resposta do servidor.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
IDisposable.Dispose()

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código.

Liberta todos os recursos utilizados pelo HttpWebResponse.

IDisposable.Dispose()

Quando sobrescrito numa classe derivada, liberta todos os recursos usados pelo WebResponse.

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

Serializa esta instância no objeto especificado SerializationInfo .

Aplica-se a

Ver também