WebProxy クラス

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebProxy.dll

ソース:

WebProxy.cs

HttpClient クラスの HTTP プロキシ設定を格納します。

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

継承

Object

WebProxy

実装

IWebProxy ISerializable

例

次のコード例では、 インスタンスを使用して HttpClient インスタンスを WebProxy 設定します。 インスタンスは HttpClient プロキシを使用して外部インターネット リソースに接続します。 (WPAD 機能の使用例については、 クラスのドキュメントを IWebProxyScript 参照してください)。

WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Proxy = proxyObject;
HttpClient^ client = gcnew HttpClient(handler);

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

注釈

WebProxyクラスには、要求の送信に Web プロキシをHttpClient使用するかどうかを判断するためにインスタンスが使用するプロキシ設定が含まれています。 グローバル Web プロキシ設定は、コンピューターとアプリケーションの構成ファイルで指定でき、アプリケーションは クラスのインスタンスを WebProxy 使用して Web プロキシの使用をカスタマイズできます。 クラスは WebProxy 、 インターフェイスの IWebProxy 基本実装です。

Web プロキシ クラスのインスタンスを取得するには、次のいずれかのメソッドを使用できます。

• WebProxy コンストラクター。

• GetDefaultProxy メソッド。

• Select メソッド。

これらのメソッドはそれぞれ、さらにカスタマイズできるインスタンスを WebProxy 提供します。それらの違いは、アプリケーションに返される前にインスタンスを初期化する方法です。 コンストラクターはWebProxy、 プロパティが に設定された WebProxy クラスのインスタンスをAddressnull返します。 要求がこの状態のインスタンスを WebProxy 使用する場合、要求の送信にプロキシは使用されません。

メソッドはGetDefaultProxy、および BypassList プロパティがWebProxyローカル コンピューターで使用される値に設定された クラスAddressBypassProxyOnLocalのインスタンスを返します。

メソッドは Select 、インターネットと構成ファイルの設定の WebProxy 組み合わせに従って設定されたプロパティを持つ クラスのインスタンスを返します。

クラスは WebProxy 、プロキシ構成スクリプトの自動検出と実行をサポートします。 この機能は、Web プロキシの自動検出 (WPAD) とも呼ばれます。 自動プロキシ構成を使用する場合、通常は Wpad.dat という名前の構成スクリプトを配置、ダウンロード、コンパイル、および実行する必要があります。 これらの操作が成功した場合、スクリプトは要求に使用できるプロキシを返します。

コンストラクター

WebProxy()	WebProxy クラスの空のインスタンスを初期化します。
WebProxy(SerializationInfo, StreamingContext)	古い. 既にシリアル化されたコンテンツを使用して、WebProxy クラスのインスタンスを初期化します。
WebProxy(String)	指定した URI を使用して、WebProxy クラスの新しいインスタンスを初期化します。
WebProxy(String, Boolean)	指定した URI とバイパス設定を使用して、WebProxy クラスの新しいインスタンスを初期化します。
WebProxy(String, Boolean, String[])	指定した URI、バイパス設定、およびバイパスする URI の一覧を使用して、WebProxy クラスの新しいインスタンスを初期化します。
WebProxy(String, Boolean, String[], ICredentials)	指定した URI、バイパス設定、バイパスする URI の一覧、および資格情報を使用して、WebProxy クラスの新しいインスタンスを初期化します。
WebProxy(String, Int32)	指定したホストとポート番号を使用して、WebProxy クラスの新しいインスタンスを初期化します。
WebProxy(Uri)	指定された WebProxy インスタンスから Uri クラスの新しいインスタンスを初期化します。
WebProxy(Uri, Boolean)	WebProxy インスタンスとバイパス設定を使用して、Uri クラスの新しいインスタンスを初期化します。
WebProxy(Uri, Boolean, String[])	指定した WebProxy インスタンス、バイパス設定、およびバイパスする URI の一覧を使用して、Uri クラスの新しいインスタンスを初期化します。
WebProxy(Uri, Boolean, String[], ICredentials)	指定した WebProxy インスタンス、バイパス設定、バイパスする URI の一覧、および資格情報を使用して、Uri クラスの新しいインスタンスを初期化します。

プロパティ

Address	プロキシ サーバーのアドレスを取得または設定します。
BypassArrayList	プロキシ サーバーを使用しないアドレスの一覧を取得します。
BypassList	プロキシ サーバーを使用しないアドレスの配列を取得または設定します。
BypassProxyOnLocal	ローカル アドレスに対してプロキシ サーバーをバイパスするかどうかを示す値を取得します。値の設定も可能です。
Credentials	認証用のプロキシ サーバーに送信する資格情報を取得または設定します。
UseDefaultCredentials	Boolean が要求と共に送信されるかどうかを制御する DefaultCredentials 値を取得または設定します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetDefaultProxy()	古い. インターネット オプションの非動的プロキシ設定を読み取ります。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo に、ターゲット オブジェクトをシリアル化するために必要なデータを設定します。
GetProxy(Uri)	要求に対するプロキシの URI を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsBypassed(Uri)	指定したホストでプロキシ サーバーを使用するかどうかを示します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

WebProxy オブジェクトをシリアル化するためにシステムによって使用されるシリアル化データとコンテキストを作成します。