WebProxy Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Contém as configurações de proxy HTTP para a classe WebRequest.
public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable
public ref class WebProxy : System::Runtime::Serialization::ISerializable
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
interface IWebProxy
interface ISerializable
[<System.Serializable>]
type WebProxy = class
interface IWebProxy
interface ISerializable
[<System.Serializable>]
type WebProxy = class
interface ISerializable
interface IWebProxy
Public Class WebProxy
Implements ISerializable, IWebProxy
Public Class WebProxy
Implements ISerializable
- Herança
-
WebProxy
- Atributos
- Implementações
Exemplos
O exemplo de código a seguir atribui uma WebProxy instância a uma WebRequest instância. A WebRequest instância usa o proxy para se conectar a recursos externos da Internet. (Para obter um exemplo que demonstra o uso do recurso WPAD, consulte a documentação da IWebProxyScript classe.)
WebProxy^ proxyObject = gcnew WebProxy( "http://proxyserver:80/",true );
WebRequest^ req = WebRequest::Create( "http://www.contoso.com" );
req->Proxy = proxyObject;
WebProxy proxyObject = new WebProxy("http://proxyserver:80/",true);
WebRequest req = WebRequest.Create("http://www.contoso.com");
req.Proxy = proxyObject;
Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
Dim req As WebRequest = WebRequest.Create("http://www.contoso.com")
req.Proxy = proxyObject
Comentários
A WebProxy classe contém as configurações de proxy que WebRequest as instâncias usam para determinar se um proxy Da Web é usado para enviar solicitações. As configurações globais de proxy da Web podem ser especificadas em arquivos de configuração de computador e aplicativo, e os aplicativos podem usar instâncias da classe para personalizar o WebProxy uso de proxy Web. A WebProxy classe é a implementação base da IWebProxy interface.
Para obter instâncias da classe de proxy Web, você pode usar qualquer um dos seguintes métodos:
O WebProxy construtor.
O método GetDefaultProxy.
O método Select.
Cada um desses métodos fornece uma WebProxy instância que você pode personalizar ainda mais; a diferença entre eles é como a instância é inicializada antes de ser retornada ao seu aplicativo. O WebProxy construtor retorna uma instância da WebProxy classe com a Address propriedade definida como null
. Quando uma solicitação usa uma WebProxy instância nesse estado, nenhum proxy é usado para enviar a solicitação.
O GetDefaultProxy método retorna uma instância da WebProxy classe com o Address, BypassProxyOnLocale BypassList as propriedades definidas para os valores usados pelo Internet Explorer 5.5 e posterior.
O Select método retorna uma instância da classe com suas WebProxy propriedades definidas de acordo com uma combinação de configurações de arquivo do Internet Explorer e de configuração.
A WebProxy classe dá suporte à detecção automática e à execução de scripts de configuração de proxy. Esse recurso também é conhecido como WPAD (Descoberta Automática de Proxy Web). Ao usar a configuração de proxy automático, um script de configuração, normalmente chamado Wpad.dat, deve ser localizado, baixado, compilado e executado. Se essas operações forem bem-sucedidas, o script retornará os proxies que podem ser usados para uma solicitação.
Construtores
WebProxy() |
Inicializa uma instância vazia da classe WebProxy. |
WebProxy(SerializationInfo, StreamingContext) |
Inicializa uma instância da classe WebProxy usando o conteúdo serializado anteriormente. |
WebProxy(String) |
Inicializa uma nova instância da classe WebProxy com URI especificado. |
WebProxy(String, Boolean) |
Inicializa uma nova instância da classe WebProxy com o URI e a configuração para ignorar especificados. |
WebProxy(String, Boolean, String[]) |
Inicializa uma nova instância da classe WebProxy com o URI especificado, configuração de bypass e a lista de URIs a ser ignorados. |
WebProxy(String, Boolean, String[], ICredentials) |
Inicializa uma nova instância da classe WebProxy com o URI especificado, configuração de bypass, a lista de URIs a ignorar e as credenciais. |
WebProxy(String, Int32) |
Inicializa uma nova instância da classe WebProxy com o host e o número da porta especificados. |
WebProxy(Uri) |
Inicializa uma nova instância da classe WebProxy da instância Uri especificada. |
WebProxy(Uri, Boolean) |
Inicializa uma nova instância da classe WebProxy com a instância Uri e a configuração de bypass. |
WebProxy(Uri, Boolean, String[]) |
Inicializa uma nova instância da classe WebProxy com a instância Uri especificada, configuração de bypass e a lista de URIs a ser ignorados. |
WebProxy(Uri, Boolean, String[], ICredentials) |
Inicializa uma nova instância da classe WebProxy com a instância Uri especificada, configuração de bypass, a lista de URIs a ser ignorados e as credenciais. |
Propriedades
Address |
Obtém ou define o endereço do servidor proxy. |
BypassArrayList |
Obtém uma lista de endereços que não usa o servidor proxy. |
BypassList |
Obtém ou define uma matriz de endereços que não usa o servidor proxy. |
BypassProxyOnLocal |
Obtém ou define um valor que indica se o servidor de proxy deve ser ignorado para endereços locais. |
Credentials |
Obtém ou define as credenciais para enviar para o servidor proxy para autenticação. |
UseDefaultCredentials |
Obtém ou define um valor Boolean que controla se o DefaultCredentials é enviado com solicitações. |
Métodos
CreateDefaultProxy() | |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetDefaultProxy() |
Obsoleto.
Obsoleto.
Obsoleto.
Lê as configurações de proxy não dinâmico do Internet Explorer. |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetObjectData(SerializationInfo, StreamingContext) |
Preenche um SerializationInfo com os dados necessários para serializar o objeto de destino. |
GetProxy(Uri) |
Retorna o URI com proxy para uma solicitação. |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
IsBypassed(Uri) |
Indica se o servidor proxy deve ser usado para o host especificado. |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Cria os dados de serialização e contexto que são usados pelo sistema para serializar um objeto WebProxy. |