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

戻り値

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

実装

例外

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 次のいずれかの条件で を返します。

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

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

  • Addressnull の場合。

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

適用対象