Language

WebProxy.IsBypassed(Uri) メソッド

定義

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

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 インスタンス。

返品

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

実装

例外

host パラメーターはnull。

例

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

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 の場合。 ローカル要求は、 http://webserver/のように URI にピリオド (.) がないことによって識別されます。

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

  • Addressがnullの場合。

その他のすべての条件は、 falseを返します。

適用対象