Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Classe HttpWebRequest

.NET Framework 4.5

Outras versões

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

Hierarquia de herança

System.Object
  System.MarshalByRefObject
    System.Net.WebRequest
      System.Net.HttpWebRequest

Namespace: System.Net
Assembly: System (em System.dll)

Sintaxe

C++

[SerializableAttribute]
public class HttpWebRequest : WebRequest, 
	ISerializable

O tipo HttpWebRequest expõe os membros a seguir.

Construtores

	Nome	Descrição
	HttpWebRequest()	Obsoleta. Inicializa uma nova instância da classe HttpWebRequest.
	HttpWebRequest(SerializationInfo, StreamingContext)	Obsoleta. Inicializa uma nova instância da classe de HttpWebRequest especificadas de instâncias de classes de SerializationInfo e de StreamingContext .

Superior

Propriedades

	Nome	Descrição
	Accept	Obtém ou define o valor de cabeçalho de Accept HTTP.
	Address	Obtém Uniform Resource Identifier (URI) do recurso de Internet que realmente responde à solicitação.
	AllowAutoRedirect	Obtém ou define um valor que indica se a solicitação deve seguir as respostas de redirecionamento.
	AllowReadStreamBuffering	Obtém ou define um valor que indica se o buffer recebido de recurso de Internet.
	AllowWriteStreamBuffering	Obtém ou define um valor que indica se o buffer enviar os dados para o recurso de Internet.
	AuthenticationLevel	Obtém ou define os valores de que indicam o nível de autenticação e representação de usadas para a solicitação. (Herdado de WebRequest.)
	AutomaticDecompression	Obtém ou define o tipo de descompressão que é usada.
	CachePolicy	Obtém ou define a política de cache para a solicitação. (Herdado de WebRequest.)
	ClientCertificates	Obtém ou define a coleção de certificados de segurança que são associados com a solicitação.
	Connection	Obtém ou define o valor de cabeçalho de Connection HTTP.
	ConnectionGroupName	Obtém ou define o nome do grupo de conexão para a solicitação. (Substitui WebRequest.ConnectionGroupName.)
	ContentLength	Obtém ou define o cabeçalho de Content-length HTTP. (Substitui WebRequest.ContentLength.)
	ContentType	Obtém ou define o valor de cabeçalho de Content-type HTTP. (Substitui WebRequest.ContentType.)
	ContinueDelegate	Obtém ou define o método delegate chamado quando HTTP 100 continua a resposta é recebido de recurso de Internet.
	ContinueTimeout	Obtém ou define um tempo limite, em segundos, para esperar o status do servidor após 100 aumentam são recebidos.
	CookieContainer	Obtém ou define os cookies associadas com a solicitação.
	CreatorInstance	Obsoleta. Quando substituído em uma classe, descendente obtém o objeto derivado da classe de factory de IWebRequestCreate usada para criar WebRequest instanciado fazendo a solicitação ao URI especificado. (Herdado de WebRequest.)
	Credentials	Obtém ou define informações sobre autenticação para a solicitação. (Substitui WebRequest.Credentials.)
	Date	Obtenha ou define o valor de Date de cabeçalho HTTP para usar em uma solicitação HTTP.
	DefaultCachePolicy	Obtém ou define a política de cache padrão para a 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 propriedade de MaximumResponseHeadersLength .
	Expect	Obtém ou define o valor de cabeçalho de Expect HTTP.
	HaveResponse	Obtém um valor que indica se uma resposta foi colocada de um recurso de Internet.
	Headers	Especifica uma coleção de pares nome/valor que compõem os cabeçalhos HTTP. (Substitui WebRequest.Headers.)
	Host	Obtenha ou define o valor de cabeçalho de hospedagem para usar em uma solicitação HTTP independente de URI de solicitação.
	IfModifiedSince	Obtém ou define o valor de cabeçalho de If-Modified-Since HTTP.
	ImpersonationLevel	Obtém ou define a representação no nível da solicitação atual. (Herdado de WebRequest.)
	KeepAlive	Obtém ou define um valor que indica se tornar persistente uma conexão ao recurso de Internet.
	MaximumAutomaticRedirections	Obtém ou define o número máximo de que redireciona a solicitação maneira.
	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 de solicitação.
	Method	Obtém ou define o método para a solicitação. (Substitui WebRequest.Method.)
	Pipelined	Obtém ou define um valor que indica se canalizar a solicitação para o recurso de Internet.
	PreAuthenticate	Obtém ou define um valor que indica se enviar um cabeçalho de autorização com a solicitação. (Substitui WebRequest.PreAuthenticate.)
	ProtocolVersion	Obtém ou define a versão HTTP para usar o para a solicitação.
	Proxy	Obtém ou define informações de proxy para a solicitação. (Substitui WebRequest.Proxy.)
	ReadWriteTimeout	Obtém ou define um tempo limite em milissegundos ao escrever a ou ao ler a partir de um fluxo.
	Referer	Obtém ou define o valor de cabeçalho de Referer HTTP.
	RequestUri	Obtém Uniform Resource Identifier (URI) de solicitação original. (Substitui WebRequest.RequestUri.)
	SendChunked	Obtém ou define um valor que indica se enviar dados nos segmentos para o recurso de 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 para usar o para a solicitação.
	SupportsCookieContainer	Obtém um valor que indica se a solicitação fornece suporte para CookieContainer.
	Timeout	Obtém ou define o valor de tempo limite em milissegundos para os métodos de GetResponse e de GetRequestStream . (Substitui WebRequest.Timeout.)
	TransferEncoding	Obtém ou define o valor de cabeçalho de Transfer-encoding HTTP.
	UnsafeAuthenticatedConnectionSharing	Obtém ou define um valor que indica se permitir compartilhar NTLM- autenticado de alta velocidade de conexão.
	UseDefaultCredentials	Obtém ou define um valor de Boolean controles que se as credenciais de opção são enviados com solicitações. (Substitui WebRequest.UseDefaultCredentials.)
	UserAgent	Obtém ou define o valor de cabeçalho de User-agent HTTP.

Superior

Métodos

	Nome	Descrição
	Abort	Cancela uma solicitação para um recurso de Internet. (Substitui WebRequest.Abort().)
	AddRange(Int32)	Adiciona um cabeçalho do intervalo de bytes em uma solicitação para um intervalo específico do início ou no fim de dados aplicativos.
	AddRange(Int64)	Adiciona um cabeçalho do intervalo de bytes em uma solicitação para um intervalo específico do início ou no fim de dados aplicativos.
	AddRange(Int32, Int32)	Adiciona um cabeçalho do intervalo de byte na solicitação para um intervalo especificado.
	AddRange(Int64, Int64)	Adiciona um cabeçalho do intervalo de byte na solicitação para um intervalo especificado.
	AddRange(String, Int32)	Adiciona um cabeçalho de intervalo para uma solicitação para um intervalo específico do início ou no fim de dados aplicativos.
	AddRange(String, Int64)	Adiciona um cabeçalho de intervalo para uma solicitação para um intervalo específico do início ou no fim de dados aplicativos.
	AddRange(String, Int32, Int32)	Adiciona um cabeçalho de intervalo para uma solicitação para um intervalo especificado.
	AddRange(String, Int64, Int64)	Adiciona um cabeçalho de intervalo para uma solicitação para um intervalo especificado.
	BeginGetRequestStream	Inicia uma solicitação assíncrona de um objeto de Stream para usar gravar dados. (Substitui WebRequest.BeginGetRequestStream(AsyncCallback, Object).)
	BeginGetResponse	Inicia uma solicitação assíncrona a um recurso de Internet. (Substitui WebRequest.BeginGetResponse(AsyncCallback, Object).)
	CreateObjRef	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.)
	EndGetRequestStream(IAsyncResult)	Termina uma solicitação assíncrona de um objeto de Stream para usar gravar dados. (Substitui WebRequest.EndGetRequestStream(IAsyncResult).)
	EndGetRequestStream(IAsyncResult, TransportContext)	Termina uma solicitação assíncrona de um objeto de Stream para usar gravar dados e saída TransportContext associado com o fluxo.
	EndGetResponse	Termina uma solicitação assíncrona a um recurso de Internet. (Substitui WebRequest.EndGetResponse(IAsyncResult).)
	Equals(Object)	Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
	Finalize	Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
	GetHashCode	Serve como uma função hash para um tipo específico. (Herdado de Object.)
	GetLifetimeService	Recupera o objeto de serviço vida útil atual que controla a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)
	GetObjectData	Infraestrutura. Preenche SerializationInfo com os dados necessários para serializar o objeto alvo. (Substitui WebRequest.GetObjectData(SerializationInfo, StreamingContext).)
	GetRequestStream()	Obtém um objeto de Stream para usar gravar dados da solicitação. (Substitui WebRequest.GetRequestStream().)
	GetRequestStream(TransportContext)	Obtém um objeto de Stream para usar gravar dados e saída de solicitação TransportContext associado com o fluxo.
	GetRequestStreamAsync	Quando substituído em uma classe descendente, retorna Stream para gravar dados para o recurso de Internet como uma operação assíncrona. (Herdado de WebRequest.)
	GetResponse	Retorna uma resposta de um recurso de Internet. (Substitui WebRequest.GetResponse().)
	GetResponseAsync	Quando substituído em uma classe, descendente retorna uma resposta a uma solicitação de Internet como uma operação assíncrona. (Herdado de WebRequest.)
	GetType	Obtém o Type da instância atual. (Herdado de Object.)
	InitializeLifetimeService	Obtém um objeto de serviço de tempo de vida para controlar a diretiva vida útil para esta instância. (Herdado de MarshalByRefObject.)
	MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object.)
	MemberwiseClone(Boolean)	Cria uma cópia superficial do atual MarshalByRefObject objeto. (Herdado de MarshalByRefObject.)
	ToString	Retorna uma string que representa o objeto atual. (Herdado de Object.)

Superior

Implementações explícitas da interface

	Nome	Descrição
	ISerializable.GetObjectData	Infraestrutura. Preenche SerializationInfo com os dados necessários para serializar o objeto alvo.

Superior

Comentários

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

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

O método de GetResponse síncrono faz uma solicitação para o recurso especificado na propriedade de RequestUri e retorna HttpWebResponse que contém a resposta. Você pode fazer uma solicitação assíncrona para o recurso usando os métodos e de BeginGetResponse de EndGetResponse .

Quando você deseja enviar dados para o recurso de GetRequestStream , o método retorna um objeto de Stream para usar enviar dados. Os métodos de BeginGetRequestStream e de EndGetRequestStream fornecem acesso assíncrona para o fluxo de enviar dados de.

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

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

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

A tabela a seguir lista os cabeçalhos HTTP que são definidos pelas propriedades ou métodos ou pelo sistema.

Header	Definida por
Aceitar	Defina a propriedade de Accept .
Conexão	Defina a propriedade de Connection , propriedade de KeepAlive .
Conteudo Comprimento	Defina a propriedade de ContentLength .
Tipo de conteúdo	Defina a propriedade de ContentType .
Espere	Defina a propriedade de Expect .
Date	Defina pelo sistema a data atual.
Hosts	Defina pelo sistema para informações atual do host.
Desde Que Se-Alterar-	Defina a propriedade de IfModifiedSince .
Intervalo	Defina pelo método de AddRange .
Referer	Defina a propriedade de Referer .
Transferência-Codificação	Defina a propriedade de TransferEncoding (a propriedade de SendChunked deve ser true).
o Agente	Defina a propriedade de UserAgent .

Observação
HttpWebRequest é automaticamente registrado. Você não precisa chamar o método de RegisterPrefix para registrar System.Net.HttpWebRequest antes de usar os URI que começam com http:// ou https://.

O computador local ou arquivo de configuração do aplicativo podem especificar que um proxy padrão é usado. Se a propriedade de Proxy for especificada, e as configurações de proxy da propriedade de Proxy substitui o computador local ou arquivo de configuração do aplicativo e a instância de HttpWebRequest usará as configurações de proxy especificadas. Se nenhum proxy é especificado em um arquivo de configuração e a propriedade de Proxy não for especificado, a classe de HttpWebRequest usa as configurações de proxy herdadas do Internet Explorer no computador local. Se não houver nenhuma configuração de proxy no Internet Explorer, a solicitação é enviada para o servidor diretamente.

A classe de HttpWebRequest analisa uma lista de desvio de proxy com os caracteres curinga herdados do Internet Explorer diferente do que a lista de desvio é analisada diretamente pelo Internet Explorer. Por exemplo, a classe de HttpWebRequest irá analisar uma lista de desvio de “nt*” do Internet Explorer como uma expressão regular de “nt.$”. Isso difere do comportamento nativo do Internet Explorer. Para um URL de “http://intxxxxx” seria ignorar o proxy usando a classe de HttpWebRequest , mas não seria ignorar o proxy usando o Internet Explorer.

Observação
O Framework "cacheia" sessões SSL conforme elas são criadas e tenta reutilizar uma sessão 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), ou tenta reutilizar uma sessão anônima se ClientCertificates estiver vazio.

Observação
Por razões de segurança, cookies estão desativadas por padrão. Se você desejar usar cookies, use a propriedade de CookieContainer para permitir cookies.

Exemplos

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

C++



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

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

Segurança do .NET Framework

WebPermission
para acessar o URI aplicativo ou qualquer URI que a solicitação será redirecionada para. Enumeração associada: Connect

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace System.Net

Outros recursos

<defaultProxy> Elemento (configurações de rede)

Alterações na autenticação NTLM para HttpWebRequest na versão 3,5 SP1

Isso foi útil para você? Sim Não

Impreciso

Sem profundidade suficiente

Mais exemplos de código são necessários

A tradução precisa ser aprimorada

(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?

Politica de Privacidade