Partilhar via


WebProxy Construtores

Definição

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();
public WebProxy ();
Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

WebProxy^ CreateProxy()
{
   return gcnew WebProxy;
}
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

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(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);
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 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.

WebProxy^ CreateProxyWithCredentials( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList,
      CredentialCache::DefaultCredentials );
}
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

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, cli::array <System::String ^> ^ BypassList);
public WebProxy (Uri? Address, bool BypassOnLocal, 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 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.

WebProxy^ CreateProxyWithBypassList( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( gcnew Uri( "http://contoso" ),
      bypassLocal,
      bypassList );
}
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

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(System::String ^ Address, bool BypassOnLocal, cli::array <System::String ^> ^ BypassList);
public WebProxy (string? Address, bool BypassOnLocal, 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

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

WebProxy^ CreateProxyWithHostAndBypassList( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList );
}
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

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);
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 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.

WebProxy^ CreateProxyWithExampleAddress( bool bypassLocal )
{
   return gcnew WebProxy( gcnew Uri( "http://contoso" ), bypassLocal );
}
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

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, cli::array <System::String ^> ^ BypassList, System::Net::ICredentials ^ Credentials);
public WebProxy (Uri? Address, bool BypassOnLocal, 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 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.

WebProxy^ CreateProxyWithCredentials2( bool bypassLocal )
{
   
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( gcnew Uri( "http://contoso" ),
      bypassLocal,
      bypassList,
      CredentialCache::DefaultCredentials );
}
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

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(System::String ^ Address, bool BypassOnLocal);
public WebProxy (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

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

WebProxy^ CreateProxyWithHostAddress( bool bypassLocal )
{
   WebProxy^ proxy = gcnew WebProxy( "http://contoso",bypassLocal );
   Console::WriteLine( "Bypass proxy for local URIs?: {0}", 
      proxy->BypassProxyOnLocal );
   return proxy;
}
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

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);
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);
new System.Net.WebProxy : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Net.WebProxy
[<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 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

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);
public WebProxy (Uri Address);
new System.Net.WebProxy : Uri -> System.Net.WebProxy
Public Sub New (Address As Uri)

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.

WebProxy^ CreateProxyWithExampleAddress()
{
   return gcnew WebProxy( gcnew Uri( "http://contoso" ) );
}
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

WebProxy(String)

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

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

public:
 WebProxy(System::String ^ Address);
public WebProxy (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

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

WebProxy^ CreateProxyWithHost()
{
   return gcnew WebProxy( "http://contoso" );
}
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

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

WebProxy^ CreateProxyWithHostAndPort()
{
   return gcnew WebProxy( "contoso",80 );
}
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