Compartilhar via


WebProxy Classe

Definição

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

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
WebProxy
Atributos
Implementações

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:

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

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

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

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â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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Cria os dados de serialização e contexto que são usados pelo sistema para serializar um objeto WebProxy.

Aplica-se a