HttpWebResponse Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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 . |