WebProxy Classe

Definição

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

public ref class WebProxy : 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

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

[<System.Serializable>]
type WebProxy = class
    interface IWebProxy
    interface ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Herança

Object

WebProxy

Atributos

SerializableAttribute

Implementações

IWebProxy ISerializable

Exemplos

O seguinte exemplo de código configura uma HttpClient instância com uma WebProxy instância. A HttpClient instância usa o proxy para se ligar a recursos externos da Internet. (Para um exemplo que demonstre a utilização da funcionalidade WPAD, consulte a documentação da IWebProxyScript classe.)

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
})

Observações

A WebProxy classe contém as definições de proxy que HttpClient as instâncias usam para determinar se um proxy Web é usado para enviar pedidos. As definições globais do proxy Web podem ser especificadas em ficheiros de configuração de máquinas e aplicações, e as aplicações podem usar instâncias da WebProxy classe para personalizar o uso do proxy Web. A WebProxy classe é a implementação base da IWebProxy interface.

Para obter instâncias da classe proxy Web, pode usar qualquer um dos seguintes métodos:

• O WebProxy construtor.
• O método GetDefaultProxy.
• O método Select.

Estes métodos fornecem cada um uma WebProxy instância que pode personalizar ainda mais; a diferença entre eles está na forma como a instância é inicializada antes de ser devolvida à sua aplicação. O WebProxy construtor devolve uma instância da WebProxy classe com a Address propriedade definida como null. Quando um pedido utiliza uma WebProxy instância neste estado, não é utilizado nenhum proxy para enviar o pedido.

O GetDefaultProxy método devolve uma instância da WebProxy classe com os Address, BypassProxyOnLocal, e BypassList propriedades definidas para os valores usados pelo computador local.

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

A WebProxy classe suporta a deteção e execução automática de scripts de configuração proxy. Esta funcionalidade é também conhecida como Web Proxy Auto-Discovery (WPAD). Ao usar configuração automática de proxy, um script de configuração, normalmente chamado Wpad.dat, deve ser localizado, descarregado, compilado e executado. Se estas operações forem bem-sucedidas, o script devolve os proxies que podem ser usados para um pedido.