WebProxy.BypassProxyOnLocal プロパティ

.NET Framework クラス ライブラリ リファレンス

WebProxy.BypassProxyOnLocal プロパティ

ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示す値を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property BypassProxyOnLocal As
 Boolean

Visual Basic (使用法)

Dim instance As WebProxy
Dim value As Boolean

value = instance.BypassProxyOnLocal

instance.BypassProxyOnLocal = value

C#

public bool BypassProxyOnLocal { get;
 set; }

C++

public:
property bool BypassProxyOnLocal {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_BypassProxyOnLocal ()

/** @property */
public void set_BypassProxyOnLocal (boolean
 value)

JScript

public function get BypassProxyOnLocal
 () : boolean

public function set BypassProxyOnLocal
 (value : boolean)

プロパティ値
ローカル アドレスのプロキシ サーバーをバイパスする場合は true。それ以外の場合は false。既定値は false です。

解説

BypassProxyOnLocal プロパティの設定により、ローカル インターネット リソースにアクセスするときに、WebRequest インスタンスがプロキシ サーバーを使用するかどうかを決めます。

BypassProxyOnLocal が true の場合、ローカル インターネット リソースへの要求はプロキシ サーバーを使用しません。ローカル要求は、http://webserver/ のように、URI にピリオド (.) がないこと、または http://localhost、http://loopback、http://127.0.0.1 などを使用したローカル サーバーへのアクセスによって識別されます。BypassProxyOnLocal が false の場合、すべてのインターネット要求はプロキシ サーバー経由で行われます。

メモ
URI にピリオドが含まれるローカル ホストへの要求でも、プロキシを使用します。URI にピリオドが含まれるローカル ホストへ要求を行う場合にプロキシを使用しないようにするには、BypassList にそのホストのエントリを作成します。

使用例

このプロパティを設定するコンストラクタを呼び出し、このプロパティの値を取得するコード例を次に示します。

C#

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;
}

C++

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

J#

public static WebProxy CreateProxyWithHostAddress(boolean
 bypassLocal)
{
    WebProxy proxy = new WebProxy("http://contoso",
 bypassLocal);
    Console.WriteLine("Bypass proxy for local URIs?: {0}",
 
        (System.Boolean)proxy.get_BypassProxyOnLocal());
    return proxy;
} //CreateProxyWithHostAddress

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebProxy クラス
WebProxy メンバ
System.Net 名前空間