WebProxy.IsBypassed(Uri) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebProxy.dll

Origem:

WebProxy.cs

Indica se o servidor proxy deve ser usado para o host especificado.

public:
 virtual bool IsBypassed(Uri ^ host);

public bool IsBypassed (Uri host);

abstract member IsBypassed : Uri -> bool
override this.IsBypassed : Uri -> bool

Public Function IsBypassed (host As Uri) As Boolean

Parâmetros

host

Uri

A instância de Uri do host a ser verificado para uso do proxy.

Retornos

Boolean

true caso o servidor proxy não deva ser usado para host; caso contrário, false.

Implementações

IsBypassed(Uri)

Exceções

ArgumentNullException

O parâmetro host é null.

Exemplos

O exemplo de código a seguir cria um WebProxy objeto e chama esse método para marcar se a lista de bypass está definida corretamente.

WebProxy^ CreateProxyAndCheckBypass( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   WebProxy^ proxy = gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList );
   
   // Test the bypass list.
   if (  !proxy->IsBypassed( gcnew Uri( "http://www.Contoso.com" ) ) )
   {
      Console::WriteLine( "Bypass not working!" );
      return nullptr;
   }
   else
   {
      Console::WriteLine( "Bypass is working." );
      return proxy;
   }
}

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

    // Test the bypass list.
    if (!proxy.IsBypassed(new Uri("http://www.Contoso.com")))
    {
        Console.WriteLine("Bypass not working!");
        return null;
    }
    else
    {
        Console.WriteLine("Bypass is working.");
        return proxy;
    }
}

Comentários

O IsBypassed método é usado para determinar se deseja ignorar o servidor proxy ao acessar um recurso da Internet.

As BypassProxyOnLocal propriedades e BypassList controlam o valor retornado do IsBypassed método .

IsBypassed retorna true sob qualquer uma das seguintes condições:

• Se BypassProxyOnLocal for true e host for um URI local. As solicitações locais são identificadas pela falta de um período (.) no URI, como em http://webserver/.

• Se host corresponder a uma expressão regular em BypassList.

• Se Address for null.

Todas as outras condições retornam false.