WebProxy クラス
アセンブリ: System (system.dll 内)


WebProxy クラスは、要求の送信に Web プロキシが使用されているかどうかを確認するために WebRequest インスタンスが使用するプロキシ設定を格納します。グローバル Web プロキシ設定は、コンピュータの構成ファイルおよびアプリケーション構成ファイルで指定でき、アプリケーションで WebProxy クラスのインスタンスを使用して、Web プロキシの使用方法をカスタマイズできます。WebProxy クラスは、IWebProxy インターフェイスの基本実装です。
Web プロキシ クラスのインスタンスは、以下のいずれかのメソッドを使用して取得できます。
これらのメソッドは、さらに詳細にカスタマイズできる WebProxy インスタンスを提供します。これらのメソッドの違いは、アプリケーションに返される前に実行されるインスタンスの初期化方法です。WebProxy コンストラクタは、Address プロパティを null 参照 (Visual Basic では Nothing) に設定して、WebProxy クラスのインスタンスを返します。要求がこの状態で WebProxy インスタンスを使用した場合、要求の送信にプロキシが使用されません。
GetDefaultProxy メソッドは、Address、BypassProxyOnLocal、BypassList の各プロパティを Internet Explorer 5.5 以降で使用される値に設定して、WebProxy クラスのインスタンスを返します。
Select メソッドは、Inernet Explorer と構成ファイルの設定の組み合わせに応じてプロパティを設定して、WebProxy クラスのインスタンスを返します。
WebProxy クラスは、プロキシ構成スクリプトの自動検出と実行をサポートしています。この機能は、WPAD (Web Proxy Auto-Discovery) とも呼ばれます。自動プロキシ構成を使用する場合は、構成スクリプト (通常は Wpad.dat) の検索、ダウンロード、コンパイル、および実行が必要です。これらの操作が成功した場合、構成スクリプトから要求に使用できるプロキシが返されます。

WebRequest インスタンスに WebProxy インスタンスを割り当てるコード例を次に示します。WebRequest インスタンスは、プロキシを使用して、外部インターネット リソースに接続します。WPAD 機能の使用方法の例については、AutomaticConfigurationScript プロパティの説明を参照してください。
Dim proxyObject As New WebProxy("http://proxyserver:80/", True) Dim req As WebRequest = WebRequest.Create("http://www.contoso.com") req.Proxy = proxyObject
WebProxy proxyObject = new WebProxy("http://proxyserver:80/" ,true); WebRequest req = WebRequest.Create("http://www.contoso.com"); req.Proxy = proxyObject;

System.Net.WebProxy


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ ()
アセンブリ: System (system.dll 内)


既定のコンストラクタは、Address プロパティを null 参照 (Visual Basic では Nothing) に設定して、WebProxy クラスの空のインスタンスを初期化します。
Address プロパティが null 参照 (Visual Basic では Nothing) の場合、IsBypassed メソッドは true を返し、GetProxy メソッドは終点アドレスを返します。


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (Uri, Boolean)
アセンブリ: System (system.dll 内)

Dim Address As Uri Dim BypassOnLocal As Boolean Dim instance As New WebProxy(Address, BypassOnLocal)


public static WebProxy CreateProxyWithExampleAddress(bool bypassLocal) { return new WebProxy(new Uri("http://contoso"), bypassLocal); }

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (String, Int32)
アセンブリ: System (system.dll 内)





Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (Uri, Boolean, String[], ICredentials)
アセンブリ: System (system.dll 内)

Public Sub New ( _ Address As Uri, _ BypassOnLocal As Boolean, _ BypassList As String(), _ Credentials As ICredentials _ )
Dim Address As Uri Dim BypassOnLocal As Boolean Dim BypassList As String() Dim Credentials As ICredentials Dim instance As New WebProxy(Address, BypassOnLocal, BypassList, Credentials)
public: WebProxy ( Uri^ Address, bool BypassOnLocal, array<String^>^ BypassList, ICredentials^ Credentials )
public WebProxy ( Uri Address, boolean BypassOnLocal, String[] BypassList, ICredentials Credentials )
public function WebProxy ( Address : Uri, BypassOnLocal : boolean, BypassList : String[], Credentials : ICredentials )

Address プロパティを Address に設定し、BypassProxyOnLocal プロパティを BypassOnLocal に設定し、BypassList プロパティを BypassList に設定し、Credentials プロパティを Credentials に設定して、WebProxy インスタンスを初期化します。

public static WebProxy CreateProxyWithCredentials2(bool bypassLocal) { // Do not use the proxy server for Contoso.com URIs. string[] bypassList = new string[]{";*.Contoso.com"}; return new WebProxy(new Uri("http://contoso"), bypassLocal, bypassList, CredentialCache.DefaultCredentials); }
WebProxy^ CreateProxyWithCredentials2( bool bypassLocal ) { // Do not use the proxy server for Contoso.com URIs. array<String^>^ bypassList = {";*.Contoso.com"}; return gcnew WebProxy( gcnew Uri( "http://contoso" ), bypassLocal, bypassList, CredentialCache::DefaultCredentials ); }
public static WebProxy CreateProxyWithCredentials2(boolean bypassLocal) { // Do not use the proxy server for Contoso.com URIs. String bypassList[] = new String[] { ";*.Contoso.com" }; return new WebProxy(new Uri("http://contoso"), bypassLocal, bypassList, CredentialCache.get_DefaultCredentials()); } //CreateProxyWithCredentials2

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (String, Boolean)
アセンブリ: System (system.dll 内)

Dim Address As String Dim BypassOnLocal As Boolean Dim instance As New WebProxy(Address, BypassOnLocal)


Address プロパティを Address が格納された Uri インスタンスに設定し、BypassProxyOnLocal プロパティを BypassOnLocal に設定して、WebProxy インスタンスを初期化します。

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

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (SerializationInfo, StreamingContext)
アセンブリ: System (system.dll 内)

Protected Sub New ( _ serializationInfo As SerializationInfo, _ streamingContext As StreamingContext _ )
Dim serializationInfo As SerializationInfo Dim streamingContext As StreamingContext Dim instance As New WebProxy(serializationInfo, streamingContext)
protected function WebProxy ( serializationInfo : SerializationInfo, streamingContext : StreamingContext )


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (Uri, Boolean, String[])
アセンブリ: System (system.dll 内)

Dim Address As Uri Dim BypassOnLocal As Boolean Dim BypassList As String() Dim instance As New WebProxy(Address, BypassOnLocal, BypassList)

Address プロパティを Address に設定し、BypassProxyOnLocal プロパティを BypassOnLocal に設定し、BypassList プロパティを BypassList に設定して、WebProxy インスタンスを初期化します。

public static WebProxy CreateProxyWithBypassList(bool bypassLocal) { // Do not use the proxy server for Contoso.com URIs. string[] bypassList = new string[]{";*.Contoso.com"}; return new WebProxy(new Uri("http://contoso"), bypassLocal, bypassList); }

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (Uri)
アセンブリ: System (system.dll 内)



public static WebProxy CreateProxyWithExampleAddress() { return new WebProxy(new Uri("http://contoso")); }

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (String)
アセンブリ: System (system.dll 内)





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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (String, Boolean, String[])
アセンブリ: System (system.dll 内)

Dim Address As String Dim BypassOnLocal As Boolean Dim BypassList As String() Dim instance As New WebProxy(Address, BypassOnLocal, BypassList)


Address プロパティを Address が格納された Uri インスタンスに設定し、BypassProxyOnLocal プロパティを BypassOnLocal に設定し、BypassList プロパティを BypassList に設定して、WebProxy インスタンスを初期化します。

public static WebProxy CreateProxyWithHostAndBypassList(bool bypassLocal) { // Do not use the proxy server for Contoso.com URIs. string[] bypassList = new string[]{";*.Contoso.com"}; return new WebProxy("http://contoso", bypassLocal, bypassList); }

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ (String, Boolean, String[], ICredentials)
アセンブリ: System (system.dll 内)

Public Sub New ( _ Address As String, _ BypassOnLocal As Boolean, _ BypassList As String(), _ Credentials As ICredentials _ )
Dim Address As String Dim BypassOnLocal As Boolean Dim BypassList As String() Dim Credentials As ICredentials Dim instance As New WebProxy(Address, BypassOnLocal, BypassList, Credentials)
public WebProxy ( string Address, bool BypassOnLocal, string[] BypassList, ICredentials Credentials )
public: WebProxy ( String^ Address, bool BypassOnLocal, array<String^>^ BypassList, ICredentials^ Credentials )
public WebProxy ( String Address, boolean BypassOnLocal, String[] BypassList, ICredentials Credentials )
public function WebProxy ( Address : String, BypassOnLocal : boolean, BypassList : String[], Credentials : ICredentials )


Address プロパティを Address が格納された Uri インスタンスに設定し、BypassProxyOnLocal プロパティを BypassOnLocal に設定し、BypassList プロパティを BypassList に設定し、Credentials プロパティを Credentials に設定して、WebProxy インスタンスを初期化します。

public static WebProxy CreateProxyWithCredentials(bool bypassLocal) { // Do not use the proxy server for Contoso.com URIs. string[] bypassList = new string[]{";*.Contoso.com"}; return new WebProxy("http://contoso", bypassLocal, bypassList, CredentialCache.DefaultCredentials); }
WebProxy^ CreateProxyWithCredentials( bool bypassLocal ) { // Do not use the proxy server for Contoso.com URIs. array<String^>^ bypassList = {";*.Contoso.com"}; return gcnew WebProxy( "http://contoso" , bypassLocal, bypassList, CredentialCache::DefaultCredentials ); }
public static WebProxy CreateProxyWithCredentials(boolean bypassLocal) { // Do not use the proxy server for Contoso.com URIs. String bypassList[] = new String[] { ";*.Contoso.com" }; return new WebProxy("http://contoso", bypassLocal, bypassList, CredentialCache.get_DefaultCredentials()); } //CreateProxyWithCredentials

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


WebProxy コンストラクタ


WebProxy プロパティ

名前 | 説明 | |
---|---|---|
![]() ![]() | BypassArrayList | プロキシ サーバーを使用しないアドレスの一覧を取得します。 |
![]() | BypassList | プロキシ サーバーを使用しないアドレスの配列を取得または設定します。 |
![]() ![]() ![]() | UseDefaultCredentials | DefaultCredentials が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。 |

WebProxy メソッド

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetDefaultProxy | Internet Explorer の非動的なプロキシ設定を読み取ります。 |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetProxy | 要求に対するプロキシの URI を返します。 |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | IsBypassed | 指定したホストでプロキシ サーバーを使用するかどうかを示します。 |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | GetObjectData | SerializationInfo に、対象オブジェクトをシリアル化するために必要なデータを設定します。 |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | System.Runtime.Serialization.ISerializable.GetObjectData | WebProxy オブジェクトをシリアル化するためにシステムによって使用されるシリアル化データとコンテキストを作成します。 |

WebProxy メンバ
WebRequest クラスの HTTP プロキシ設定を格納します。
WebProxy データ型で公開されるメンバを以下の表に示します。



名前 | 説明 | |
---|---|---|
![]() ![]() | BypassArrayList | プロキシ サーバーを使用しないアドレスの一覧を取得します。 |
![]() | BypassList | プロキシ サーバーを使用しないアドレスの配列を取得または設定します。 |
![]() ![]() ![]() | UseDefaultCredentials | DefaultCredentials が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetDefaultProxy | Internet Explorer の非動的なプロキシ設定を読み取ります。 |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetProxy | 要求に対するプロキシの URI を返します。 |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | IsBypassed | 指定したホストでプロキシ サーバーを使用するかどうかを示します。 |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | GetObjectData | SerializationInfo に、対象オブジェクトをシリアル化するために必要なデータを設定します。 |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | System.Runtime.Serialization.ISerializable.GetObjectData | WebProxy オブジェクトをシリアル化するためにシステムによって使用されるシリアル化データとコンテキストを作成します。 |

- WebProxyのページへのリンク