WebProxy.IsBypassed(Uri) Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebProxy.dll

Zdroj:

WebProxy.cs

Určuje, zda se má použít proxy server pro zadaného hostitele.

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

Instance Uri hostitele, která má zkontrolovat použití proxy serveru.

Návraty

Boolean

truepokud proxy server nemá být použit pro host; v opačném případě . false

Implementuje

IsBypassed(Uri)

Výjimky

ArgumentNullException

Parametr host je null.

Příklady

Následující příklad kódu vytvoří WebProxy objekt a zavolá tuto metodu ke kontrole, zda je správně nastaven seznam vynechat.

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

Poznámky

Metoda IsBypassed se používá k určení, zda se má při přístupu k internetovému prostředku obejít proxy server.

Vlastnosti BypassProxyOnLocal a BypassList řídí návratové hodnoty IsBypassed metody.

IsBypassed za true některé z následujících podmínek:

• Pokud BypassProxyOnLocal je true a host je místní identifikátor URI. Místní požadavky jsou identifikovány nedostatkem tečky (.) v identifikátoru URI, jako v http://webserver/.

• Pokud host odpovídá regulárnímu výrazu v BypassList.

• Pokud Address je null.

Všechny ostatní podmínky vrátí false.