WebProxy Classe

Definição

Contém as configurações de proxy HTTP para a classe WebRequest.Contains HTTP proxy settings for the WebRequest class.

public ref class WebProxy : System::Runtime::Serialization::ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
    interface ISerializable
    interface IWebProxy
Public Class WebProxy
Implements ISerializable
Herança
WebProxy
Atributos
Implementações

Exemplos

O exemplo de código a seguir atribui uma instância de WebProxy a uma instância de WebRequest.The following code example assigns a WebProxy instance to a WebRequest instance. A instância de WebRequest usa o proxy para se conectar a recursos externos da Internet.The WebRequest instance uses the proxy to connect to external Internet resources. (Para obter um exemplo que demonstra o uso do recurso WPAD, consulte a documentação da classe IWebProxyScript.)(For an example that demonstrates using the WPAD feature, see the documentation for the IWebProxyScript class.)

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 classe WebProxy contém as configurações de proxy que WebRequest instâncias usam para determinar se um proxy Web é usado para enviar solicitações.The WebProxy class contains the proxy settings that WebRequest instances use to determine whether a Web proxy is used to send requests. 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 WebProxy para personalizar o uso do proxy Web.Global Web proxy settings can be specified in machine and application configuration files, and applications can use instances of the WebProxy class to customize Web proxy use. A classe WebProxy é a implementação base da interface IWebProxy.The WebProxy class is the base implementation of the IWebProxy interface.

Para obter instâncias da classe de proxy Web, você pode usar qualquer um dos seguintes métodos:To obtain instances of the Web proxy class, you can use any of the following methods:

Esses métodos fornecem uma instância de WebProxy que você pode personalizar ainda mais; a diferença entre eles é como a instância é inicializada antes de ser retornada ao seu aplicativo.These methods each supply a WebProxy instance that you can further customize; the difference between them is how the instance is initialized before it is returned to your application. O Construtor WebProxy retorna uma instância da classe WebProxy com a propriedade Address definida como null.The WebProxy constructor returns an instance of the WebProxy class with the Address property set to null. Quando uma solicitação usa uma instância de WebProxy nesse estado, nenhum proxy é usado para enviar a solicitação.When a request uses a WebProxy instance in this state, no proxy is used to send the request.

O método GetDefaultProxy retorna uma instância da classe WebProxy com as propriedades Address, BypassProxyOnLocale BypassList definidas para os valores usados pelo Internet Explorer 5,5 e posterior.The GetDefaultProxy method returns an instance of the WebProxy class with the Address, BypassProxyOnLocal, and BypassList properties set to the values used by Internet Explorer 5.5 and later.

O método Select retorna uma instância da classe WebProxy com as propriedades de ti definidas de acordo com uma combinação das configurações do Internet Explorer e do arquivo de configuração.The Select method returns an instance of the WebProxy class with it properties set according to a combination of Internet Explorer and configuration file settings.

A classe WebProxy dá suporte à detecção automática e à execução de scripts de configuração de proxy.The WebProxy class supports automatic detection and execution of proxy configuration scripts. Esse recurso também é conhecido como WPAD (Descoberta Automática de Proxy Web).This feature is also known as Web Proxy Auto-Discovery (WPAD). Ao usar a configuração de proxy automática, um script de configuração, normalmente denominado WPAD. dat, deve ser localizado, baixado, compilado e executado.When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. Se essas operações forem bem-sucedidas, o script retornará os proxies que podem ser usados para uma solicitação.If these operations are successful, the script returns the proxies that can be used for a request.

Construtores

WebProxy()

Inicializa uma instância vazia da classe WebProxy.Initializes an empty instance of the WebProxy class.

WebProxy(SerializationInfo, StreamingContext)

Inicializa uma instância da classe WebProxy usando o conteúdo serializado anteriormente.Initializes an instance of the WebProxy class using previously serialized content.

WebProxy(String)

Inicializa uma nova instância da classe WebProxy com URI especificado.Initializes a new instance of the WebProxy class with the specified URI.

WebProxy(String, Boolean)

Inicializa uma nova instância da classe WebProxy com o URI e a configuração para ignorar especificados.Initializes a new instance of the WebProxy class with the specified URI and bypass setting.

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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, and list of URIs to bypass.

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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, list of URIs to bypass, and credentials.

WebProxy(String, Int32)

Inicializa uma nova instância da classe WebProxy com o host e o número da porta especificados.Initializes a new instance of the WebProxy class with the specified host and port number.

WebProxy(Uri)

Inicializa uma nova instância da classe WebProxy da instância Uri especificada.Initializes a new instance of the WebProxy class from the specified Uri instance.

WebProxy(Uri, Boolean)

Inicializa uma nova instância da classe WebProxy com a instância Uri e a configuração de bypass.Initializes a new instance of the WebProxy class with the Uri instance and bypass setting.

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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, and list of URIs to bypass.

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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, list of URIs to bypass, and credentials.

Propriedades

Address

Obtém ou define o endereço do servidor proxy.Gets or sets the address of the proxy server.

BypassArrayList

Obtém uma lista de endereços que não usa o servidor proxy.Gets a list of addresses that do not use the proxy server.

BypassList

Obtém ou define uma matriz de endereços que não usa o servidor proxy.Gets or sets an array of addresses that do not use the proxy server.

BypassProxyOnLocal

Obtém ou define um valor que indica se os endereços locais devem ser ignorados no servidor proxy.Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

Credentials

Obtém ou define as credenciais para enviar para o servidor proxy para autenticação.Gets or sets the credentials to submit to the proxy server for authentication.

UseDefaultCredentials

Obtém ou define um valor Boolean que controla se o DefaultCredentials é enviado com solicitações.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Métodos

CreateDefaultProxy()
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetDefaultProxy()

Lê as configurações de proxy não dinâmico do Internet Explorer.Reads the Internet Explorer nondynamic proxy settings.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Preenche um SerializationInfo com os dados necessários para serializar o objeto de destino.Populates a SerializationInfo with the data that is needed to serialize the target object.

GetProxy(Uri)

Retorna o URI com proxy para uma solicitação.Returns the proxied URI for a request.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IsBypassed(Uri)

Indica se o servidor proxy deve ser usado para o host especificado.Indicates whether to use the proxy server for the specified host.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(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.Creates the serialization data and context that are used by the system to serialize a WebProxy object.

Aplica-se a