WebProxy Construtores

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.WebProxy.dll

Inicializa uma nova instância da classe WebProxy.

Sobrecargas

Nome	Description
WebProxy()	Inicializa uma instância vazia da WebProxy classe.
WebProxy(String, Boolean, String[], ICredentials)	Inicializa uma nova instância da WebProxy classe com o URI especificado, a configuração de bypass, a lista de URIs a serem ignoradas e as credenciais.
WebProxy(Uri, Boolean, String[])	Inicializa uma nova instância da WebProxy classe com a instância especificada Uri , a configuração de bypass e a lista de URIs a serem ignoradas.
WebProxy(String, Boolean, String[])	Inicializa uma nova instância da WebProxy classe com o URI especificado, a configuração de bypass e a lista de URIs a serem ignoradas.
WebProxy(Uri, Boolean)	Inicializa uma nova instância da WebProxy classe com a instância e a Uri configuração de bypass.
WebProxy(Uri, Boolean, String[], ICredentials)	Inicializa uma nova instância da WebProxy classe com a instância especificada Uri , a configuração de bypass, a lista de URIs a serem ignoradas e as credenciais.
WebProxy(String, Boolean)	Inicializa uma nova instância da WebProxy classe com o URI especificado e a configuração de bypass.
WebProxy(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma instância da WebProxy classe usando conteúdo serializado anteriormente.
WebProxy(Uri)	Inicializa uma nova instância da WebProxy classe da instância especificada Uri .
WebProxy(String)	Inicializa uma nova instância da WebProxy classe com o URI especificado.
WebProxy(String, Int32)	Inicializa uma nova instância da WebProxy classe com o host e o número de porta especificados.

WebProxy()

Origem:

WebProxy.cs

Inicializa uma instância vazia da WebProxy classe.

public:
 WebProxy();

public WebProxy();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxy()
{
    return new WebProxy();
}

Comentários

O construtor sem parâmetros inicializa uma instância vazia da WebProxy classe com a Address propriedade definida como null.

Quando a Address propriedade é null, o IsBypassed método retorna true e o GetProxy método retorna o endereço de destino.

WebProxy(String, Boolean, String[], ICredentials)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com o URI especificado, a configuração de bypass, a lista de URIs a serem ignoradas e as credenciais.

public:
 WebProxy(System::String ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList, System::Net::ICredentials ^ Credentials);

public WebProxy(string? Address, bool BypassOnLocal, string[]? BypassList, System.Net.ICredentials? Credentials);

new System.Net.WebProxy : string * bool * string[] * System.Net.ICredentials -> System.Net.WebProxy

Public Sub New (Address As String, BypassOnLocal As Boolean, BypassList As String(), Credentials As ICredentials)

Parâmetros

Address

String

O URI do servidor proxy.

BypassOnLocal

Boolean

true para ignorar o proxy para endereços locais; caso contrário, false.

BypassList

String[]

Uma matriz de cadeias de caracteres de expressão regular que contém os URIs dos servidores a serem ignorados.

Credentials

ICredentials

Uma ICredentials instância a ser enviada ao servidor proxy para autenticação.

Exceções

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithCredentials(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy("http://contoso",
        bypassLocal,
        bypassList,
        CredentialCache.DefaultCredentials);
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como uma Uri instância que contém Address, a BypassProxyOnLocal propriedade definida como BypassOnLocal, a BypassList propriedade definida como BypassListe a Credentials propriedade definida como Credentials.

Confira também

• BypassProxyOnLocal
• BypassList

WebProxy(Uri, Boolean, String[])

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com a instância especificada Uri , a configuração de bypass e a lista de URIs a serem ignoradas.

public:
 WebProxy(Uri ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList);

public WebProxy(Uri? Address, bool BypassOnLocal, string[]? BypassList);

new System.Net.WebProxy : Uri * bool * string[] -> System.Net.WebProxy

Public Sub New (Address As Uri, BypassOnLocal As Boolean, BypassList As String())

Parâmetros

Address

Uri

Uma Uri instância que contém o endereço do servidor proxy.

BypassOnLocal

Boolean

true para ignorar o proxy para endereços locais; caso contrário, false.

BypassList

String[]

Uma matriz de cadeias de caracteres de expressão regular que contém os URIs dos servidores a serem ignorados.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithBypassList(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy(new Uri("http://contoso"),
        bypassLocal,
        bypassList);
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como Address, a BypassProxyOnLocal propriedade definida como BypassOnLocal, e a BypassList propriedade definida como BypassList.

WebProxy(String, Boolean, String[])

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com o URI especificado, a configuração de bypass e a lista de URIs a serem ignoradas.

public:
 WebProxy(System::String ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList);

public WebProxy(string? Address, bool BypassOnLocal, string[]? BypassList);

new System.Net.WebProxy : string * bool * string[] -> System.Net.WebProxy

Public Sub New (Address As String, BypassOnLocal As Boolean, BypassList As String())

Parâmetros

Address

String

O URI do servidor proxy.

BypassOnLocal

Boolean

true para ignorar o proxy para endereços locais; caso contrário, false.

BypassList

String[]

Uma matriz de cadeias de caracteres de expressão regular que contêm os URIs dos servidores a serem ignorados.

Exceções

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithHostAndBypassList(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy("http://contoso",
        bypassLocal,
        bypassList);
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como uma Uri instância que contém Address, a BypassProxyOnLocal propriedade definida como BypassOnLocale a BypassList propriedade definida como BypassList.

Confira também

• BypassProxyOnLocal
• BypassList

WebProxy(Uri, Boolean)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com a instância e a Uri configuração de bypass.

public:
 WebProxy(Uri ^ Address, bool BypassOnLocal);

public WebProxy(Uri? Address, bool BypassOnLocal);

new System.Net.WebProxy : Uri * bool -> System.Net.WebProxy

Public Sub New (Address As Uri, BypassOnLocal As Boolean)

Parâmetros

Address

Uri

Uma Uri instância que contém o endereço do servidor proxy.

BypassOnLocal

Boolean

true para ignorar o proxy para endereços locais; caso contrário, false.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithExampleAddress(bool bypassLocal)
{
    return new WebProxy(new Uri("http://contoso"), bypassLocal);
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como Address e com a BypassProxyOnLocal propriedade definida como BypassOnLocal.

WebProxy(Uri, Boolean, String[], ICredentials)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com a instância especificada Uri , a configuração de bypass, a lista de URIs a serem ignoradas e as credenciais.

public:
 WebProxy(Uri ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList, System::Net::ICredentials ^ Credentials);

public WebProxy(Uri? Address, bool BypassOnLocal, string[]? BypassList, System.Net.ICredentials? Credentials);

new System.Net.WebProxy : Uri * bool * string[] * System.Net.ICredentials -> System.Net.WebProxy

Public Sub New (Address As Uri, BypassOnLocal As Boolean, BypassList As String(), Credentials As ICredentials)

Parâmetros

Address

Uri

Uma Uri instância que contém o endereço do servidor proxy.

BypassOnLocal

Boolean

true para ignorar o proxy para endereços locais; caso contrário, false.

BypassList

String[]

Uma matriz de cadeias de caracteres de expressão regular que contém os URIs dos servidores a serem ignorados.

Credentials

ICredentials

Uma ICredentials instância a ser enviada ao servidor proxy para autenticação.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithCredentials2(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    return new WebProxy(new Uri("http://contoso"),
        bypassLocal,
        bypassList,
        CredentialCache.DefaultCredentials);
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como Address, a BypassProxyOnLocal propriedade definida como BypassOnLocal, a BypassList propriedade definida como BypassList, e a Credentials propriedade definida como Credentials.

WebProxy(String, Boolean)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com o URI especificado e a configuração de bypass.

public:
 WebProxy(System::String ^ Address, bool BypassOnLocal);

public WebProxy(string? Address, bool BypassOnLocal);

new System.Net.WebProxy : string * bool -> System.Net.WebProxy

Public Sub New (Address As String, BypassOnLocal As Boolean)

Parâmetros

Address

String

O URI do servidor proxy.

BypassOnLocal

Boolean

true para ignorar o proxy para endereços locais; caso contrário, false.

Exceções

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithHostAddress(bool bypassLocal)
{
    WebProxy proxy =  new WebProxy("http://contoso", bypassLocal);
    Console.WriteLine("Bypass proxy for local URIs?: {0}",
       proxy.BypassProxyOnLocal);
    return proxy;
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como uma Uri instância que contém Address e a BypassProxyOnLocal propriedade definida como BypassOnLocal.

Confira também

• BypassProxyOnLocal

WebProxy(SerializationInfo, StreamingContext)

Origem:

WebProxy.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma instância da WebProxy classe usando conteúdo serializado anteriormente.

protected:
 WebProxy(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected WebProxy(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Net.WebProxy : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Net.WebProxy

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parâmetros

serializationInfo

SerializationInfo

Os dados de serialização.

streamingContext

StreamingContext

O contexto dos dados serializados.

Atributos

ObsoleteAttribute

Comentários

Esse método é chamado pelo sistema para desserializar uma WebProxy instância; os aplicativos não o chamam.

WebProxy(Uri)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe da instância especificada Uri .

public:
 WebProxy(Uri ^ Address);

public WebProxy(Uri? Address);

new System.Net.WebProxy : Uri -> System.Net.WebProxy

Public Sub New (Address As Uri)

Parâmetros

Address

Uri

Uma Uri instância que contém o endereço do servidor proxy.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithExampleAddress()
{
    return new WebProxy(new Uri("http://contoso"));
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como o Address parâmetro.

WebProxy(String)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com o URI especificado.

public:
 WebProxy(System::String ^ Address);

public WebProxy(string? Address);

new System.Net.WebProxy : string -> System.Net.WebProxy

Public Sub New (Address As String)

Parâmetros

Address

String

O URI do servidor proxy.

Exceções

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithHost()
{
    return new WebProxy("http://contoso");
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como uma Uri instância que contém Address.

WebProxy(String, Int32)

Origem:

WebProxy.cs

Inicializa uma nova instância da WebProxy classe com o host e o número de porta especificados.

public:
 WebProxy(System::String ^ Host, int Port);

public WebProxy(string Host, int Port);

new System.Net.WebProxy : string * int -> System.Net.WebProxy

Public Sub New (Host As String, Port As Integer)

Parâmetros

Host

String

O nome do host proxy.

Port

Int32

O número da porta a Host ser usado.

Exceções

UriFormatException

O URI formado pela combinação Host e Port não é um URI válido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

public static WebProxy CreateProxyWithHostAndPort()
{
    return new WebProxy("contoso", 80);
}

Comentários

A WebProxy instância é inicializada com a Address propriedade definida como uma Uri instância do formulário http:// Host : Port.