WebProxy.IsBypassed(Uri) メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebProxy.dll

ソース:

WebProxy.cs

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

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

戻り値

Boolean

host でプロキシ サーバーを使用しない場合は 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 、インターネット リソースにアクセスするときにプロキシ サーバーをバイパスするかどうかを決定するために使用されます。

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

IsBypassed は、 true 次のいずれかの条件で を返します。

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

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

• Address が null の場合。

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