WebProxy Classe

Definição

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

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Herança

Object

WebProxy

Atributos

SerializableAttribute

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 = 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 Da Web podem ser especificadas em arquivos de configuração de aplicativos e computadores, 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 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.