Ler em inglês

Partilhar via


WebProxy Construtores

Definição

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe WebProxy.

Sobrecargas

WebProxy()

Inicializa uma instância vazia da classe WebProxy.

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(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(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(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[], 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.

WebProxy(String, Boolean)

Inicializa uma nova instância da classe WebProxy com o URI e a configuração para ignorar especificados.

WebProxy(SerializationInfo, StreamingContext)
Obsoleto.

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

WebProxy(Uri)

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

WebProxy(String)

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

WebProxy(String, Int32)

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

WebProxy()

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

Inicializa uma instância vazia da classe WebProxy.

public WebProxy ();

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 nullcomo .

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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.

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

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 ignorar.

Credentials
ICredentials

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

Exceções

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 BypassOnLocalcomo , a BypassList propriedade definida BypassListcomo e a Credentials propriedade definida Credentialscomo .

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(Uri, Boolean, String[])

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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.

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

Parâmetros

Address
Uri

Uma instância Uri 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 ignorar.

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 Addresscomo , a BypassProxyOnLocal propriedade definida BypassOnLocalcomo e a BypassList propriedade definida BypassListcomo .

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(String, Boolean, String[])

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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

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

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

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 BypassOnLocalcomo e a BypassList propriedade definida BypassListcomo .

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(Uri, Boolean)

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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

public WebProxy (Uri? Address, bool BypassOnLocal);
public WebProxy (Uri Address, bool BypassOnLocal);

Parâmetros

Address
Uri

Uma instância Uri 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 como chamar esse 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 Address como e com a BypassProxyOnLocal propriedade definida BypassOnLocalcomo .

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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.

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

Parâmetros

Address
Uri

Uma instância Uri 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 ignorar.

Credentials
ICredentials

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

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 Addresscomo , a BypassProxyOnLocal propriedade definida BypassOnLocalcomo , a BypassList propriedade definida BypassListcomo e a Credentials propriedade definida Credentialscomo .

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(String, Boolean)

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

Inicializa uma nova instância da classe WebProxy com o URI e a configuração para ignorar especificados.

public WebProxy (string? Address, bool BypassOnLocal);
public WebProxy (string Address, bool BypassOnLocal);

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

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 BypassOnLocalcomo .

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(SerializationInfo, StreamingContext)

Origem:
WebProxy.cs
Origem:
WebProxy.cs
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 classe WebProxy usando o 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);

Parâmetros

serializationInfo
SerializationInfo

Os dados de serialização.

streamingContext
StreamingContext

O contexto para os dados serializados.

Atributos

Comentários

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

Aplica-se a

.NET 9 e outras versões
Produto Versões (Obsoleto)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(Uri)

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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

public WebProxy (Uri? Address);
public WebProxy (Uri Address);

Parâmetros

Address
Uri

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

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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 .

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(String)

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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

public WebProxy (string? Address);
public WebProxy (string Address);

Parâmetros

Address
String

O URI do servidor proxy.

Exceções

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WebProxy(String, Int32)

Origem:
WebProxy.cs
Origem:
WebProxy.cs
Origem:
WebProxy.cs

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

public WebProxy (string Host, int Port);

Parâmetros

Host
String

O nome do host do proxy.

Port
Int32

O número da porta em Host a ser usada.

Exceções

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

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1