WebProxy.IsBypassed(Uri) 方法

定義

命名空間:

System.Net

組件:

System.Net.WebProxy.dll

來源:

WebProxy.cs

指示是否要為指定主機使用 Proxy 伺服器。

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

要檢查 Proxy 使用之主機 Uri 的執行個體。

傳回

Boolean

如果不應該為 host 使用 Proxy 伺服器，則為 true，否則為 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 可用來判斷存取因特網資源時是否略過 Proxy 伺服器。

BypassProxyOnLocal和 BypassList 屬性會控制 方法的IsBypassed傳回值。

IsBypassed 在下列任一情況下會 true 傳回 ：

• 如果 BypassProxyOnLocal 為 true ，且 host 為本機 URI。 本機要求是由 URI 中缺少句點 (.) 來識別，如 中 http://webserver/所示。

• 如果 host 符合中的 BypassList正則表達式。

• 如果 Address 為 null。

所有其他條件都會傳回 false。