WebProxy Classe

Definição

Namespace:

System.Net

Assembly:

System.Net.WebProxy.dll

Origem:

WebProxy.cs

Contém as configurações de proxy HTTP para a classe HttpClient.

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Herança

Object

WebProxy

Implementações

IWebProxy ISerializable

Exemplos

O exemplo de código a seguir configura uma HttpClient instância com uma WebProxy instância . A HttpClient 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);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Proxy = proxyObject;
HttpClient^ client = gcnew HttpClient(handler);

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

Comentários

A WebProxy classe contém as configurações de proxy que HttpClient as instâncias usam para determinar se um proxy Web é usado para enviar solicitações. As configurações globais de proxy 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 construtor WebProxy.

• 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 nullcomo . 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 as Addresspropriedades , BypassProxyOnLocale BypassList definidas para os valores usados pelo computador local.

O Select método retorna uma instância da classe com as WebProxy propriedades definidas de acordo com uma combinação de configurações de arquivo de configuração e Internet.

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 automática de proxy, 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

Nome	Description
WebProxy()	Inicializa uma instância vazia da classe WebProxy.
WebProxy(SerializationInfo, StreamingContext)	Obsoleto. 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

Nome	Description
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

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetDefaultProxy()	Obsoleto. Lê as configurações de proxy não dinâmicas das opções da Internet.
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

Nome	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Cria os dados de serialização e contexto que são usados pelo sistema para serializar um objeto WebProxy.