WebProxy.BypassProxyOnLocal プロパティ

定義

ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

public:
 property bool BypassProxyOnLocal { bool get(); void set(bool value); };
public bool BypassProxyOnLocal { get; set; }
member this.BypassProxyOnLocal : bool with get, set
Public Property BypassProxyOnLocal As Boolean

プロパティ値

ローカル アドレスのプロキシ サーバーをバイパスする場合は true。それ以外の場合は falsetrue to bypass the proxy server for local addresses; otherwise, false. 既定値は false です。The default value is false.

次のコード例は、このプロパティを設定し、このプロパティの値を取得するコンストラクターを呼び出す方法を示しています。The following code example demonstrates calling a constructor that sets this property and getting the value of this property.

WebProxy^ CreateProxyWithHostAddress( bool bypassLocal )
{
   WebProxy^ proxy = gcnew WebProxy( "http://contoso",bypassLocal );
   Console::WriteLine( "Bypass proxy for local URIs?: {0}", 
      proxy->BypassProxyOnLocal );
   return proxy;
}
public static WebProxy CreateProxyWithHostAddress(bool bypassLocal)
{
    WebProxy proxy =  new WebProxy("http://contoso", bypassLocal);
    Console.WriteLine("Bypass proxy for local URIs?: {0}", 
       proxy.BypassProxyOnLocal);
    return proxy;
}

注釈

BypassProxyOnLocal プロパティの設定によって、WebRequest インスタンスがローカルインターネットリソースにアクセスするときにプロキシサーバーを使用するかどうかが決まります。The setting of the BypassProxyOnLocal property determines whether WebRequest instances use the proxy server when accessing local Internet resources.

BypassProxyOnLocaltrue の場合、ローカル インターネット リソースへの要求はプロキシ サーバーを使用しません。If BypassProxyOnLocal is true, requests to local Internet resources do not use the proxy server. ローカル要求は、URI にピリオド (.) がないか、http://webserver/のように、またはローカルサーバー (http://localhosthttp://loopbackhttp://127.0.0.1など) にアクセスすることによって識別されます。Local requests are identified by the lack of a period (.) in the URI, as in http://webserver/, or access the local server, including http://localhost, http://loopback, or http://127.0.0.1. BypassProxyOnLocalfalse の場合、すべてのインターネット要求はプロキシ サーバー経由で行われます。When BypassProxyOnLocal is false, all Internet requests are made through the proxy server.

注意

ピリオドを含む URI を持つローカルホストに対する要求では、プロキシが使用されます。Requests to a local host with a URI that contain a period use the proxy. このような場合にプロキシを使用しないようにするには、BypassListでホストのエントリを作成します。To avoid using a proxy in these cases, create an entry for the host in the BypassList.

適用対象