HttpWebResponse Classe

Definição

Fornece uma implementação específica de HTTP da classe WebResponse.Provides an HTTP-specific implementation of the WebResponse class.

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
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
    interface IDisposable
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.The following example returns an HttpWebResponse from an 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 classe WebResponse.This class contains support for HTTP-specific uses of the properties and methods of the WebResponse class. A classe HttpWebResponse é usada para criar aplicativos de cliente autônomos HTTP que enviam solicitações HTTP e recebem respostas HTTP.The HttpWebResponse class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.

Observação

Não confunda HttpWebResponse com a classe HttpResponse que é usada em aplicativos ASP.NET e cujos métodos e propriedades são expostos por meio do ASP. Objeto de Response intrínseco da rede.Do not confuse HttpWebResponse with the HttpResponse class that is used in ASP.NET applications and whose methods and properties are exposed through ASP.NET's intrinsic Response object.

Você nunca deve criar diretamente uma instância da classe HttpWebResponse.You should never directly create an instance of the HttpWebResponse class. Em vez disso, use a instância retornada por uma chamada para HttpWebRequest.GetResponse.Instead, use the instance returned by a call to HttpWebRequest.GetResponse. Você deve chamar o Stream.Close ou o método HttpWebResponse.Close para fechar a resposta e liberar a conexão para reutilização.You must call either the Stream.Close or the HttpWebResponse.Close method to close the response and release the connection for reuse. Não é necessário chamar Stream.Close e HttpWebResponse.Close, mas isso não causa um erro.It is not necessary to call both Stream.Close and HttpWebResponse.Close, but doing so does not cause an error.

As informações de cabeçalho comuns retornadas do recurso da Internet são expostas como propriedades da classe.Common header information returned from the Internet resource is exposed as properties of the class. Consulte a tabela a seguir para obter uma lista completa.See the following table for a complete list. Outros cabeçalhos podem ser lidos da propriedade Headers como pares de nome/valor.Other headers can be read from the Headers property as name/value pairs.

A tabela a seguir mostra os cabeçalhos HTTP comuns que estão disponíveis por meio de propriedades da classe HttpWebResponse.The following table shows the common HTTP headers that are available through properties of the HttpWebResponse class.

CabeçalhoHeader PropriedadeProperty
Codificação de conteúdoContent-Encoding ContentEncoding
Tamanho do conteúdoContent-Length ContentLength
Tipo de conteúdoContent-Type ContentType
Última modificaçãoLast-Modified LastModified
ServidorServer Server

O conteúdo da resposta do recurso da Internet é retornado como um Stream chamando o método GetResponseStream.The contents of the response from the Internet resource are returned as a Stream by calling the GetResponseStream method.

Construtores

HttpWebResponse()

Inicializa uma nova instância da classe HttpWebResponse.Initializes a new instance of the HttpWebResponse class.

HttpWebResponse(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe HttpWebResponse das instâncias SerializationInfo e StreamingContext especificadas.Initializes a new instance of the HttpWebResponse class from the specified SerializationInfo and StreamingContext instances.

Propriedades

CharacterSet

Obtém o conjunto de caracteres da resposta.Gets the character set of the response.

ContentEncoding

Obtém o método que é usado para codificar o corpo da resposta.Gets the method that is used to encode the body of the response.

ContentLength

Obtém o tamanho do conteúdo retornado pela solicitação.Gets the length of the content returned by the request.

ContentType

Obtém o tipo de conteúdo da resposta.Gets the content type of the response.

Cookies

Obtém ou define os cookies associados a essa resposta.Gets or sets the cookies that are associated with this response.

Headers

Obtém os cabeçalhos que estão associados a essa resposta do servidor.Gets the headers that are associated with this response from the server.

IsFromCache

Obtém um valor Boolean que indica se essa resposta foi obtida do cache.Gets a Boolean value that indicates whether this response was obtained from the cache.

(Herdado de WebResponse)
IsMutuallyAuthenticated

Obtém um valor Boolean que indica se o servidor e o cliente foram ambos autenticados.Gets a Boolean value that indicates whether both client and server were authenticated.

LastModified

Obtém a última data e hora em que o conteúdo da resposta foi modificado.Gets the last date and time that the contents of the response were modified.

Method

Obtém o método que é usado para retornar a resposta.Gets the method that is used to return the response.

ProtocolVersion

Obtém a versão do protocolo HTTP usada na resposta.Gets the version of the HTTP protocol that is used in the response.

ResponseUri

Obtém o URI do recurso da Internet que respondeu à solicitação.Gets the URI of the Internet resource that responded to the request.

Server

Obtém o nome do servidor que enviou a resposta.Gets the name of the server that sent the response.

StatusCode

Obtém o status da resposta.Gets the status of the response.

StatusDescription

Obtém a descrição do status retornada com a resposta.Gets the status description returned with the response.

SupportsHeaders

Obtém um valor que indica se os cabeçalhos têm ou não suporte.Gets a value that indicates whether headers are supported.

Métodos

Close()

Fecha o fluxo de resposta.Closes the response stream.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera os recursos não gerenciados usados pelo objeto WebResponse.Releases the unmanaged resources used by the WebResponse object.

(Herdado de WebResponse)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo HttpWebResponse e, opcionalmente, descarta os recursos gerenciados.Releases the unmanaged resources used by the HttpWebResponse, and optionally disposes of the managed resources.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Retorna um valor de hash para uma instância de HttpWebResponse.Returns a hash value for a HttpWebResponse instance.

GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.Populates a SerializationInfo with the data needed to serialize the target object.

GetResponseHeader(String)

Obtém o conteúdo de um cabeçalho que foi retornado com a resposta.Gets the contents of a header that was returned with the response.

GetResponseStream()

Obtém o fluxo usado para ler o corpo da resposta do servidor.Gets the stream that is used to read the body of the response from the server.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()

Libera todos os recursos usados pelo HttpWebResponse.Releases all resources used by the HttpWebResponse.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializa esta instância para o objeto SerializationInfo especificado.Serializes this instance into the specified SerializationInfo object.

Aplica-se a

Veja também