WebProxy クラス

リファレンス

定義

名前空間:: System.Net

アセンブリ:: System.Net.WebProxy.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

public ref class WebProxy : System::Runtime::Serialization::ISerializable

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

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

[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

[<System.Serializable>]
type WebProxy = class
    interface IWebProxy
    interface ISerializable

[<System.Serializable>]
type WebProxy = class
    interface ISerializable
    interface IWebProxy

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

継承: Object
WebProxy

属性: SerializableAttribute

実装: 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 Internet Explorer 5.5 以降で使用される値に設定されたクラスAddress BypassProxyOnLocalのインスタンスを返します。

メソッドは Select 、Internet Explorer と構成ファイルの設定の 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 値を取得または設定します。

メソッド

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

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

適用対象