HttpWebRequest Classe

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Requests.dll

Origem:

HttpWebRequest.cs

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

public ref class HttpWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable

public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

type HttpWebRequest = class
    inherit WebRequest
    interface ISerializable

Public Class HttpWebRequest
Inherits WebRequest
Implements ISerializable

Herança

Object

MarshalByRefObject

WebRequest

HttpWebRequest

Implementações

ISerializable

Exemplos

O exemplo de código a seguir cria um HttpWebRequest para o URI http://www.contoso.com/.

HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");

Dim myReq As HttpWebRequest = _
    WebRequest.Create("http://www.contoso.com/")

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

A HttpWebRequest classe fornece suporte para as propriedades e métodos definidos em WebRequest e para propriedades e métodos adicionais que permitem que o usuário interaja diretamente com servidores usando HTTP.

Não use o HttpWebRequest construtor. Use o WebRequest.Create método para inicializar novos HttpWebRequest objetos. Se o esquema do URI (Uniform Resource Identifier) for http:// ou https://retornar Create um HttpWebRequest objeto.

O GetResponse método faz uma solicitação síncrona para o recurso especificado na RequestUri propriedade e retorna um HttpWebResponse que contém o objeto de resposta. Os dados de resposta podem ser recebidos usando o fluxo retornado por GetResponseStream. Se o objeto de resposta ou o fluxo de resposta estiver fechado, os dados restantes serão perdidos. Os dados restantes serão drenados e o soquete será reutilizado para solicitações subsequentes ao fechar o objeto ou fluxo de resposta se as seguintes condições forem mantidas: é uma solicitação mantida ativa ou em pipeline, apenas uma pequena quantidade de dados precisa ser recebida ou os dados restantes são recebidos em um pequeno intervalo de tempo. Se nenhuma das condições mencionadas mantiver ou o tempo de drenagem for excedido, o soquete será fechado. Para conexões mantidas ou em pipeline, é altamente recomendável que o aplicativo leia os fluxos até o EOF. Isso garante que o soquete seja usado novamente para solicitações subsequentes, resultando em melhor desempenho e menos recursos usados.

Quando você deseja enviar dados para o recurso, o GetRequestStream método retorna um Stream objeto a ser usado para enviar dados. O e EndGetRequestStream os BeginGetRequestStream métodos fornecem acesso assíncrono ao fluxo de dados de envio.

Para autenticação de cliente com HttpWebRequest, o certificado do cliente deve ser instalado no Repositório de Certificados do usuário atual.

A HttpWebRequest classe lança um WebException quando ocorrem erros ao acessar um recurso. A WebException.Status propriedade contém um WebExceptionStatus valor que indica a origem do erro. Quando WebException.Status é WebExceptionStatus.ProtocolError, a Response propriedade contém o HttpWebResponse recebido do recurso.

HttpWebRequest expõe valores comuns de cabeçalho HTTP enviados ao recurso da Internet como propriedades, definidos por métodos ou definidos pelo sistema; a tabela a seguir contém uma lista completa. Você pode definir outros cabeçalhos na Headers propriedade como pares nome/valor. Observe que servidores e caches podem alterar ou adicionar cabeçalhos durante a solicitação.

A tabela a seguir lista os cabeçalhos HTTP definidos por propriedades ou métodos ou pelo sistema.

Cabeçalho	Definido por
Accept	Definido pela Accept propriedade.
Connection	Definido pela Connection propriedade, KeepAlive propriedade.
Content-Length	Definido pela ContentLength propriedade.
Content-Type	Definido pela ContentType propriedade.
Expect	Definido pela Expect propriedade.
Date	Definido pelo sistema como a data atual.
Host	Defina pelo sistema como informações atuais do host.
If-Modified-Since	Definido pela IfModifiedSince propriedade.
Range	Definido pelo AddRange método.
Referer	Definido pela Referer propriedade.
Transfer-Encoding	Definido pela TransferEncoding propriedade (a SendChunked propriedade deve ser true).
User-Agent	Definido pela UserAgent propriedade.

Nota

HttpWebRequest é registrado automaticamente. Você não precisa chamar o RegisterPrefix método para se registrar System.Net.HttpWebRequest antes de usar URIs começando com http:// ou https://.

O arquivo de configuração de aplicativo ou computador local pode especificar que um proxy padrão seja usado. Se a Proxy propriedade for especificada, as configurações de proxy da Proxy propriedade substituirão o computador local ou o arquivo de configuração do aplicativo e a HttpWebRequest instância usará as configurações de proxy especificadas. Se nenhum proxy for especificado em um arquivo de configuração e a Proxy propriedade não for especificada, a HttpWebRequest classe usará as configurações de proxy herdadas das opções da Internet no computador local. Se não houver configurações de proxy nas opções da Internet, a solicitação será enviada diretamente ao servidor.

Nota

O Framework armazena em cache sessões SSL à medida que são criadas e tenta reutilizar uma sessão armazenada em cache para uma nova solicitação, se possível. Ao tentar reutilizar uma sessão SSL, o Framework usa o primeiro elemento de ClientCertificates (se houver um) ou tenta reutilizar uma sessão anônima se ClientCertificates estiver vazio.

Nota

Por motivos de segurança, os cookies são desabilitados por padrão. Se você quiser usar cookies, use a CookieContainer propriedade para habilitar cookies.

Para aplicativos que usam TLS/SSL por meio de APIs como HttpClient, HttpWebRequest, FTPClient, SmtpClient e SsStream, o .NET bloqueia algoritmos de codificação e hash inseguros para conexões por padrão. Talvez seja necessário recusar esse comportamento para manter a interoperabilidade com serviços existentes do SSL3 ou serviços TLS w/ RC4. Não é possível se conectar a um servidor usando as APIs ServicePointManager ou SslStream após a atualização para o .NET Framework 4.6 explica como modificar seu código para desabilitar esse comportamento, se necessário.

Construtores

Nome	Description
HttpWebRequest(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe das HttpWebRequest instâncias e StreamingContext classes SerializationInfo especificadas. Este construtor é obsoleto.

Propriedades

Nome	Description
Accept	Obtém ou define o valor do Accept cabeçalho HTTP.
Address	Obtém o URI (Uniform Resource Identifier) do recurso da Internet que realmente responde à solicitação.
AllowAutoRedirect	Obtém ou define um valor que indica se a solicitação deve seguir respostas de redirecionamento.
AllowReadStreamBuffering	Obtém ou define um valor que indica se o recurso recebido da Internet deve ser armazenado em buffer.
AllowWriteStreamBuffering	Obtém ou define um valor que indica se os dados enviados para o recurso da Internet devem ser armazenados em buffer.
AuthenticationLevel	Obtém ou define valores que indicam o nível de autenticação e representação usados para essa solicitação. (Herdado de WebRequest)
AutomaticDecompression	Obtém ou define o tipo de descompactação usado.
CachePolicy	Obtém ou define a política de cache para essa solicitação. (Herdado de WebRequest)
ClientCertificates	Obtém ou define a coleção de certificados de segurança associados a essa solicitação.
Connection	Obtém ou define o valor do Connection cabeçalho HTTP.
ConnectionGroupName	Obtém ou define o nome do grupo de conexões para a solicitação.
ContentLength	Obtém ou define o Content-length cabeçalho HTTP.
ContentType	Obtém ou define o valor do Content-type cabeçalho HTTP.
ContinueDelegate	Obtém ou define o método delegado chamado quando uma resposta HTTP 100 continua é recebida do recurso da Internet.
ContinueTimeout	Obtém ou define um tempo limite, em milissegundos, para aguardar até que o 100-Continue seja recebido do servidor.
CookieContainer	Obtém ou define os cookies associados à solicitação.
Credentials	Obtém ou define informações de autenticação para a solicitação.
Date	Obtém ou define o valor do Date cabeçalho HTTP a ser usado em uma solicitação HTTP.
DefaultCachePolicy	Obtém ou define a política de cache padrão para essa solicitação.
DefaultMaximumErrorResponseLength	Obtém ou define o comprimento máximo padrão de uma resposta de erro HTTP.
DefaultMaximumResponseHeadersLength	Obtém ou define o padrão para a MaximumResponseHeadersLength propriedade.
Expect	Obtém ou define o valor do Expect cabeçalho HTTP.
HaveResponse	Obtém um valor que indica se uma resposta foi recebida de um recurso da Internet.
Headers	Especifica uma coleção de pares nome/valor que compõem os cabeçalhos HTTP.
Host	Obtém ou define o valor do cabeçalho host a ser usado em uma solicitação HTTP independente do URI da solicitação.
IfModifiedSince	Obtém ou define o valor do If-Modified-Since cabeçalho HTTP.
ImpersonationLevel	Obtém ou define o nível de representação da solicitação atual. (Herdado de WebRequest)
KeepAlive	Obtém ou define um valor que indica se é necessário fazer uma conexão persistente com o recurso da Internet.
MaximumAutomaticRedirections	Obtém ou define o número máximo de redirecionamentos que a solicitação segue.
MaximumResponseHeadersLength	Obtém ou define o comprimento máximo permitido dos cabeçalhos de resposta.
MediaType	Obtém ou define o tipo de mídia da solicitação.
Method	Obtém ou define o método para a solicitação.
Pipelined	Obtém ou define um valor que indica se a solicitação deve ser pipeline para o recurso da Internet.
PreAuthenticate	Obtém ou define um valor que indica se um cabeçalho de autorização deve ser enviado com a solicitação.
ProtocolVersion	Obtém ou define a versão do HTTP a ser usada para a solicitação.
Proxy	Obtém ou define informações de proxy para a solicitação.
ReadWriteTimeout	Obtém ou define um tempo limite em milissegundos ao gravar ou ler de um fluxo.
Referer	Obtém ou define o valor do Referer cabeçalho HTTP.
RequestUri	Obtém o URI (Uniform Resource Identifier) original da solicitação.
SendChunked	Obtém ou define um valor que indica se os dados devem ser enviados em segmentos para o recurso da Internet.
ServerCertificateValidationCallback	Obtém ou define uma função de retorno de chamada para validar o certificado do servidor.
ServicePoint	Obtém o ponto de serviço a ser usado para a solicitação.
SupportsCookieContainer	Obtém um valor que indica se a solicitação fornece suporte para um CookieContainer.
Timeout	Obtém ou define o valor de tempo limite em milissegundos para os métodos e GetRequestStream() os GetResponse() métodos.
TransferEncoding	Obtém ou define o valor do Transfer-encoding cabeçalho HTTP.
UnsafeAuthenticatedConnectionSharing	Obtém ou define um valor que indica se o compartilhamento de conexão autenticada por NTLM de alta velocidade deve ser permitido.
UseDefaultCredentials	Obtém ou define um Boolean valor que controla se as credenciais padrão são enviadas com solicitações.
UserAgent	Obtém ou define o valor do User-agent cabeçalho HTTP.

Métodos

Nome	Description
Abort()	Cancela uma solicitação para um recurso da Internet.
AddRange(Int32, Int32)	Adiciona um cabeçalho de intervalo de bytes à solicitação de um intervalo especificado.
AddRange(Int32)	Adiciona um cabeçalho de intervalo de bytes a uma solicitação de um intervalo específico desde o início ou o final dos dados solicitados.
AddRange(Int64, Int64)	Adiciona um cabeçalho de intervalo de bytes à solicitação de um intervalo especificado.
AddRange(Int64)	Adiciona um cabeçalho de intervalo de bytes a uma solicitação de um intervalo específico desde o início ou o final dos dados solicitados.
AddRange(String, Int32, Int32)	Adiciona um cabeçalho de intervalo a uma solicitação de um intervalo especificado.
AddRange(String, Int32)	Adiciona um cabeçalho Range a uma solicitação para um intervalo específico desde o início ou o fim dos dados solicitados.
AddRange(String, Int64, Int64)	Adiciona um cabeçalho de intervalo a uma solicitação de um intervalo especificado.
AddRange(String, Int64)	Adiciona um cabeçalho Range a uma solicitação para um intervalo específico desde o início ou o fim dos dados solicitados.
BeginGetRequestStream(AsyncCallback, Object)	Inicia uma solicitação assíncrona para um Stream objeto a ser usado para gravar dados.
BeginGetResponse(AsyncCallback, Object)	Inicia uma solicitação assíncrona para um recurso da Internet.
EndGetRequestStream(IAsyncResult, TransportContext)	Encerra uma solicitação assíncrona para um Stream objeto a ser usado para gravar dados e gera o TransportContext fluxo associado.
EndGetRequestStream(IAsyncResult)	Encerra uma solicitação assíncrona para um Stream objeto a ser usado para gravar dados.
EndGetResponse(IAsyncResult)	Encerra uma solicitação assíncrona para um recurso da Internet.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
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. Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.
GetRequestStream()	Obtém um Stream objeto a ser usado para gravar dados de solicitação.
GetRequestStream(TransportContext)	Obtém um Stream objeto a ser usado para gravar dados de solicitação e gera o TransportContext associado ao fluxo.
GetRequestStreamAsync()	Quando substituído em uma classe descendente, retorna um Stream para gravar dados no recurso da Internet como uma operação assíncrona. (Herdado de WebRequest)
GetResponse()	Retorna uma resposta de um recurso da Internet.
GetResponseAsync()	Quando substituído em uma classe descendente, retorna uma resposta a uma solicitação da Internet como uma operação assíncrona. (Herdado de WebRequest)
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
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.

Confira também

• Elemento DefaultProxy (Configurações de Rede)
• Alterações na autenticação NTLM para HTTPWebRequest na versão 3.5 SP1