WebProxy.IsBypassed(Uri) Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebProxy.dll

Исходный код:

WebProxy.cs

Показывает, используется ли данный прокси-сервер для заданного узла.

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

Параметры

host

Uri

Принадлежащий узлу экземпляр Uri для проверки использования прокси-сервера.

Возвращаемое значение

Boolean

Значение true, если прокси-сервер не должен использоваться для host; в противном случае — false.

Реализации

IsBypassed(Uri)

Исключения

ArgumentNullException

Параметр host имеет значение null.

Примеры

В следующем примере кода создается WebProxy объект и вызывается этот метод для проверки правильности задания списка обхода.

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;
    }
}

Комментарии

Метод IsBypassed используется для определения того, следует ли обходить прокси-сервер при доступе к интернет-ресурсу.

Свойства BypassProxyOnLocal и BypassList управляют возвращаемым значением IsBypassed метода .

IsBypassed возвращается true при любом из следующих условий:

• Если BypassProxyOnLocal имеет значение true и host является локальным универсальным кодом ресурса (URI). Локальные запросы определяются отсутствием точки (.) в URI, как в http://webserver/.

• Если host соответствует регулярному выражению в BypassList.

• Если Address имеет значение null.

Все остальные условия возвращают значение false.