WebProxy Construtores

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.WebProxy.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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

public WebProxy ();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra a chamada desse 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

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse 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 como BypassOnLocal, a BypassList propriedade definida como BypassListe a Credentials propriedade definida como Credentials.

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 a chamada desse 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 como BypassOnLocale a BypassList propriedade definida como BypassList.

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

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse 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 como BypassOnLocale a BypassList propriedade definida como BypassList.

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 a chamada desse 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 a chamada desse 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 como BypassOnLocal, a BypassList propriedade definida como BypassListe a Credentials propriedade definida como Credentials.

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

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse 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 como BypassOnLocal.

Confira também

BypassProxyOnLocal

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: ObsoleteAttribute

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 a chamada desse 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

UriFormatException

Address é um URI inválido.

Exemplos

O exemplo de código a seguir demonstra a chamada desse 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

UriFormatException

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 a chamada desse 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

WebProxy Construtores

Definição

Sobrecargas

WebProxy()

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

WebProxy(Uri, Boolean, String[])

Parâmetros

Exemplos

Comentários

Aplica-se a

WebProxy(String, Boolean, String[])

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

WebProxy(Uri, Boolean)

Parâmetros

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exemplos

Comentários

Aplica-se a

WebProxy(String, Boolean)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

WebProxy(SerializationInfo, StreamingContext)

Parâmetros

Comentários

Aplica-se a

WebProxy(Uri)

Parâmetros

Exemplos

Comentários

Aplica-se a

WebProxy(String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

WebProxy(String, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Comentários

Recursos adicionais