WebProxy.IsBypassed(Uri) WebProxy.IsBypassed(Uri) WebProxy.IsBypassed(Uri) WebProxy.IsBypassed(Uri) Method

定義

指定したホストでプロキシ サーバーを使用するかどうかを示します。Indicates whether to use the proxy server for the specified host.

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 Uri Uri

プロキシの使用を確認するホストの Uri インスタンス。The Uri instance of the host to check for proxy use.

戻り値

host でプロキシ サーバーを使用しない場合は true。それ以外の場合は falsetrue if the proxy server should not be used for host; otherwise, false.

実装

例外

host パラメーターが null です。The host parameter is null.

次のコード例ではWebProxy 、オブジェクトを作成し、このメソッドを呼び出して、バイパスリストが適切に設定されているかどうかを確認します。The following code example creates a WebProxy object and calls this method to check whether the bypass list is properly set.

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は、インターネットリソースへのアクセス時にプロキシサーバーをバイパスするかどうかを決定するために使用されます。The IsBypassed method is used to determine whether to bypass the proxy server when accessing an Internet resource.

プロパティBypassProxyOnLocalBypassListプロパティは、 IsBypassedメソッドの戻り値を制御します。The BypassProxyOnLocal and BypassList properties control the return value of the IsBypassed method.

IsBypassedtrueのいずれかの条件に該当する場合は、が返されます。IsBypassed returns true under any of the following conditions:

  • BypassProxyOnLocaltruehostがローカル URI である場合は。If BypassProxyOnLocal is true and host is a local URI. ローカル要求は、URI http://webserver/にピリオド (.) がないことによって識別されます。Local requests are identified by the lack of a period (.) in the URI, as in http://webserver/.

  • hostBypassList正規表現と一致する場合は。If host matches a regular expression in BypassList.

  • Addressnull の場合。If Address is null.

その他のすべてfalseの条件はを返します。All other conditions return false.

適用対象