WebProxy.IsBypassed メソッド

.NET Framework クラス ライブラリ リファレンス

WebProxy.IsBypassed メソッド

指定したホストでプロキシ サーバーを使用するかどうかを示します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function IsBypassed ( _
    host As Uri _
) As Boolean

Visual Basic (使用法)

Dim instance As WebProxy
Dim host As Uri
Dim returnValue As Boolean

returnValue = instance.IsBypassed(host)

C#

public bool IsBypassed (
    Uri host
)

C++

public:
virtual bool IsBypassed (
    Uri^ host
) sealed

J#

public final boolean IsBypassed (
    Uri host
)

JScript

public final function IsBypassed (
    host : Uri
) : boolean

パラメータ

host

プロキシの使用を確認するホストの Uri インスタンス。

戻り値
host でプロキシ サーバーを使用しない場合は true。それ以外の場合は false。

解説

IsBypassed メソッドを使用して、インターネット リソースにアクセスする場合に、プロキシ サーバーをバイパスするかどうかを決めます。

BypassProxyOnLocal プロパティと BypassList プロパティは、IsBypassed メソッドの戻り値を制御します。

IsBypassed は、次のいずれかの条件に基づいて true を返します。

• BypassProxyOnLocal が true で、host がローカル URI の場合。ローカル要求は、"http://webserver/" のように、URI にピリオド (.) がないことによって識別されます。

• host が BypassList の正規表現と一致する場合。

• Address が null 参照 (Visual Basic では Nothing) の場合。

その他のすべての場合には、false を返します。

使用例

WebProxy オブジェクトを作成し、このメソッドを呼び出して、バイパス一覧が正しく設定されているかどうかを確認するコード例を次に示します。

C#

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

C++

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

J#

public static WebProxy CreateProxyAndCheckBypass(boolean
 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;
    }
} //CreateProxyAndCheckBypass

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebProxy クラス
WebProxy メンバ
System.Net 名前空間