Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe WebRequest

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Faz uma solicitação para um URI (Uniform Resource Identifier). Esta é uma classe abstract.

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


[SerializableAttribute]
public abstract class WebRequest : MarshalByRefObject, ISerializable

NomeDescrição
System_CAPS_protmethodWebRequest()

Inicializa uma nova instância da classe WebRequest.

System_CAPS_protmethodWebRequest(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe WebRequest das instâncias especificadas das classes SerializationInfo e StreamingContext.

NomeDescrição
System_CAPS_pubpropertyAuthenticationLevel

Obtém ou define valores que indicam o nível de autenticação e representação usada para esta solicitação.

System_CAPS_pubpropertyCachePolicy

Obtém ou define a política de cache para essa solicitação.

System_CAPS_pubpropertyConnectionGroupName

Quando substituído em uma classe decrescente, obtém ou define o nome do grupo de conexão para a solicitação.

System_CAPS_pubpropertyContentLength

Quando substituído em uma classe descendente, obtém ou define o tamanho de conteúdo dos dados de solicitação enviados.

System_CAPS_pubpropertyContentType

Quando substituído em uma classe descendente, obtém ou define o tipo de conteúdo dos dados de solicitação enviados.

System_CAPS_pubpropertyCreatorInstance

Obsoleto.Quando substituído em uma classe descendente, obtém o objeto de fábrica derivado da classe IWebRequestCreate usada para criar o WebRequest instanciado para criar a solicitação para o URI especificado.

System_CAPS_pubpropertyCredentials

Quando substituído em uma classe descendente, obtém ou define as credenciais de rede usadas para autenticar a solicitação com o recurso da Internet.

System_CAPS_pubpropertySystem_CAPS_staticDefaultCachePolicy

Obtém ou define a política de cache padrão para essa solicitação.

System_CAPS_pubpropertySystem_CAPS_staticDefaultWebProxy

Obtém ou define o proxy HTTP global.

System_CAPS_pubpropertyHeaders

Quando substituído em uma classe descendente, obtém ou define uma coleção de pares nome-valor do cabeçalho associado à solicitação.

System_CAPS_pubpropertyImpersonationLevel

Obtém ou define o nível de representação para a solicitação atual.

System_CAPS_pubpropertyMethod

Quando substituído em uma classe descendente, obtém ou define o método de protocolo a ser usado nesta solicitação.

System_CAPS_pubpropertyPreAuthenticate

Quando substituído em uma classe descendente, indica se é necessário autenticar previamente a solicitação.

System_CAPS_pubpropertyProxy

Quando substituído em uma classe descendente, obtém ou define o proxy de rede a ser usado para acessar esse recurso de Internet.

System_CAPS_pubpropertyRequestUri

Quando substituído em uma classe descendente, obtém o URI do recurso da Internet associado com a solicitação.

System_CAPS_pubpropertyTimeout

Obtém ou define a duração, em milissegundos, antes que a solicitação atinja o tempo limite.

System_CAPS_pubpropertyUseDefaultCredentials

Quando substituído em uma classe descendente, obtém ou define um valor Boolean que controla se DefaultCredentials são enviados com solicitações.

NomeDescrição
System_CAPS_pubmethodAbort()

Anula a solicitação

System_CAPS_pubmethodBeginGetRequestStream(AsyncCallback, Object)

Quando é substituído em uma classe descendente, fornece uma versão assíncrona do método GetRequestStream.

System_CAPS_pubmethodBeginGetResponse(AsyncCallback, Object)

Quando substituído em uma classe descendente, inicia uma solicitação assíncrona para um recurso de Internet.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreateDefault(Uri)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreateHttp(String)

Inicializa uma nova instância HttpWebRequest com a cadeia de caracteres de URI especificada.

System_CAPS_pubmethodSystem_CAPS_staticCreateHttp(Uri)

Inicializa uma nova instância HttpWebRequest para o URI especificado.

System_CAPS_pubmethodCreateObjRef(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.(Herdado de MarshalByRefObject.)

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult)

Quando substituído em uma classe descendente, retorna um Stream para gravar dados no recurso da Internet.

System_CAPS_pubmethodEndGetResponse(IAsyncResult)

Quando substituído em uma classe descendente, retorna um WebResponse.

System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.(Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.(Herdado de MarshalByRefObject.)

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.

System_CAPS_pubmethodGetRequestStream()

Quando substituído em uma classe descendente, retorna um Stream para gravar dados no recurso da Internet.

System_CAPS_pubmethodGetRequestStreamAsync()

Quando substituído em uma classe descendente, retorna um Stream para gravar dados no recurso da Internet como uma operação assíncrona.

System_CAPS_pubmethodGetResponse()

Quando é substituído em uma classe descendente, retorna uma resposta a uma solicitação à Internet.

System_CAPS_pubmethodGetResponseAsync()

Quando é substituído em uma classe descendente, retorna uma resposta a uma solicitação à Internet como uma operação assíncrona.

System_CAPS_pubmethodSystem_CAPS_staticGetSystemWebProxy()

Retorna um proxy configurado com as configurações do Internet Explorer ou do usuário representado no momento.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.(Herdado de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.(Herdado de MarshalByRefObject.)

System_CAPS_pubmethodSystem_CAPS_staticRegisterPortableWebRequestCreator(IWebRequestCreate)

Obsoleto.Registrar um objeto IWebRequestCreate.

System_CAPS_pubmethodSystem_CAPS_staticRegisterPrefix(String, IWebRequestCreate)

Registra um descendente de WebRequest para o URI especificado.

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Quando substituído em uma classe descendente, popula uma instância SerializationInfo com os dados necessários para serializar o WebRequest.

WebRequesté o abstract a classe base para o modelo de solicitação/resposta do .NET Framework para acessar dados da Internet. Um aplicativo que usa o modelo de solicitação/resposta pode solicitar dados da Internet de maneira independente de protocolo, em que o aplicativo funciona com instâncias da WebRequest classe enquanto classes descendentes específicas de protocolo realizarem os detalhes de a solicitação.

Solicitações são enviadas de um aplicativo para um URI específico, como uma página da Web em um servidor. O URI determina a classe descendente adequada para criar uma lista de WebRequest descendentes registrado para o aplicativo. WebRequestdescendentes normalmente são registrados para lidar com um protocolo específico, como HTTP ou FTP, mas podem ser registrados para manipular uma solicitação para um servidor específico ou em um servidor.

O WebRequest classe lança um WebException quando ocorrem erros ao acessar um recurso de Internet. O Status propriedade é uma da WebExceptionStatus valores que indicam a origem do erro. Quando Status é WebExceptionStatus.ProtocolError, o Response propriedade contém o WebResponse recebida do recurso da Internet.

Porque o WebRequest classe é um abstract de classe, o comportamento real de WebRequest instâncias em tempo de execução é determinado pela classe descendente retornada por Create método. Para obter mais informações sobre valores padrão e exceções, consulte a documentação para as classes descendentes, como HttpWebRequest e FileWebRequest.

System_CAPS_noteObservação

Use o Create método para inicializar novas WebRequest instâncias. Não use o WebRequest construtor.

System_CAPS_noteObservação

Se o aplicativo que cria o objeto WebRequest é executado com as credenciais de um usuário Normal, o aplicativo não será capaz de acessar certificados instalados no repositório de computador local, a menos que a permissão tiver sido fornecida explicitamente ao usuário para fazer isso.

Observações para os Herdeiros:

Ao herdar de WebRequest, você deve substituir os seguintes membros: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream, BeginGetRequestStream, EndGetRequestStream , GetResponse, BeginGetResponse, e EndGetResponse. Além disso, você deve fornecer uma implementação de IWebRequestCreate interface, que define o Create usado durante a chamada de método Create. Você deve registrar a classe que implementa o IWebRequestCreate interface, usando o RegisterPrefix método ou o arquivo de configuração.

O exemplo a seguir mostra como criar um WebRequest de instância e retornar a resposta.

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Examples.System.Net
{
    public class WebRequestGetExample
    {
        public static void Main ()
        {
            // Create a request for the URL. 		
            WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
            // If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials;
            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
            // Display the status.
            Console.WriteLine (response.StatusDescription);
            // Get the stream containing content returned by the server.
            Stream dataStream = response.GetResponseStream ();
            // Open the stream using a StreamReader for easy access.
            StreamReader reader = new StreamReader (dataStream);
            // Read the content.
            string responseFromServer = reader.ReadToEnd ();
            // Display the content.
            Console.WriteLine (responseFromServer);
            // Cleanup the streams and the response.
            reader.Close ();
            dataStream.Close ();
            response.Close ();
        }
    }
}

WebPermission

To access the requested URI or any URI that the request is redirected to. Associated enumeration: F:System.Net.NetworkAccess.Connect.

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

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

Retornar ao início
Mostrar: