FtpWebRequest.Proxy プロパティ

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

FtpWebRequest.Proxy プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

FTP サーバーとの通信に使用するプロキシを取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 Proxy As IWebProxy

Visual Basic (使用法)

Dim instance As FtpWebRequest
Dim value As IWebProxy

value = instance.Proxy

instance.Proxy = value

C#

public override IWebProxy Proxy { get; set;
 }

C++

public:
virtual property IWebProxy^ Proxy {
    IWebProxy^ get () override;
    void set (IWebProxy^ value) override;
}

J#

/** @property */
public IWebProxy get_Proxy ()

/** @property */
public void set_Proxy (IWebProxy value)

JScript

public override function get
 Proxy () : IWebProxy

public override function set
 Proxy (value : IWebProxy)

プロパティ値
FTP サーバーとの通信を行う IWebProxy インスタンス。

例外

例外の種類	条件
ArgumentNullException	このプロパティは null 参照 (Visual Basic では Nothing) に設定できません。
InvalidOperationException	既に処理中の要求で、このプロパティに対して新しい値が指定されました。

解説

Proxy プロパティは、FTP サーバーとの通信を行う IWebProxy インスタンスを識別します。プロキシは、構成ファイル、および Internet Explorer の [ローカル エリア ネットワーク (LAN) の設定] を使用してシステムによって設定されます。プロキシが使用されないように指定するには、Proxy を GlobalProxySelection.GetEmptyWebProxy メソッドが返すプロキシ インスタンスに設定します。自動プロキシ検出の詳細については、「自動プロキシ検出」を参照してください。

要求のストリームにデータを書き込む前、または応答を取得する前に、Proxy を設定する必要があります。GetRequestStream、BeginGetRequestStream、GetResponse、または BeginGetResponse の各メソッドを呼び出した後に Proxy を変更すると、InvalidOperationException 例外が発生します。

FtpWebRequest クラスは、HTTP プロキシおよび ISA ファイアウォール クライアント プロキシをサポートしています。

指定したプロキシが HTTP プロキシの場合は、DownloadFile、ListDirectory、および ListDirectoryDetails の各コマンドだけがサポートされます。

使用例

このプロパティ値を表示するコード例を次に示します。

C#

IWebProxy proxy = request.Proxy;
if (proxy != null)
{
    Console.WriteLine("Proxy: {0}", proxy.GetProxy(request.RequestUri));
} 
else
{
    Console.WriteLine("Proxy: (none)");
}

Console.WriteLine("ConnectionGroup: {0}",
    request.ConnectionGroupName == null ? "none" : request.ConnectionGroupName
);

プラットフォーム

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FtpWebRequest クラス
FtpWebRequest メンバ
System.Net 名前空間
FtpWebResponse
FtpStatusCode 列挙体
WebRequestMethods.Ftp
WebRequest
WebResponse
WebClient
WebProxy
GlobalProxySelection