WebProxy.IsBypassed(Uri) Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebProxy.dll

Źródło:

WebProxy.cs

Wskazuje, czy używać serwera proxy dla określonego hosta.

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

Parametry

host

Uri

Wystąpienie Uri hosta do sprawdzania użycia serwera proxy.

Zwraca

Boolean

truejeśli serwer proxy nie powinien być używany dla host; w przeciwnym razie . false

Implementuje

IsBypassed(Uri)

Wyjątki

ArgumentNullException

Parametr host ma wartość null.

Przykłady

Poniższy przykład kodu tworzy WebProxy obiekt i wywołuje tę metodę, aby sprawdzić, czy lista obejścia jest prawidłowo ustawiona.

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

Uwagi

Metoda IsBypassed służy do określania, czy należy pominąć serwer proxy podczas uzyskiwania dostępu do zasobu internetowego.

Właściwości BypassProxyOnLocal i BypassList kontrolują wartość zwracaną IsBypassed metody .

IsBypassed metoda zwraca true wartość w dowolnym z następujących warunków:

• Jeśli BypassProxyOnLocal element to true i host jest lokalnym identyfikatorem URI. Żądania lokalne są identyfikowane przez brak kropki (.) w identyfikatorze URI, jak w pliku http://webserver/.

• Jeśli host dopasuje wyrażenie regularne w elemecie BypassList.

• Jeśli Address wartość to null.

Wszystkie inne warunki zwracają wartość false.