FtpWebRequest.KeepAlive プロパティ

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

FtpWebRequest.KeepAlive プロパティ

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

要求の完了後に FTP サーバーへの制御接続を閉じるかどうかを指定する Boolean 値を取得または設定します。

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

Visual Basic (宣言)

Public Property KeepAlive As
 Boolean

Visual Basic (使用法)

Dim instance As FtpWebRequest
Dim value As Boolean

value = instance.KeepAlive

instance.KeepAlive = value

C#

public bool KeepAlive { get;
 set; }

C++

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

J#

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

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

JScript

public function get KeepAlive
 () : boolean

public function set KeepAlive
 (value : boolean)

プロパティ値
サーバーへの接続を破棄させない場合は true。それ以外の場合は false。既定値は true です。

例外

例外の種類	条件
InvalidOperationException	既に処理中の要求で、このプロパティに対して新しい値が指定されました。

解説

KeepAlive プロパティが false に設定された場合は、Close メソッドを呼び出すと、制御接続が閉じます。

GetRequestStream、BeginGetRequestStream、GetResponse、または BeginGetResponse の各メソッドを呼び出した後に KeepAlive を変更すると、InvalidOperationException 例外が発生します。

使用例

指定した FtpWebRequest オブジェクトのプロパティ値を、取得したり表示したりするコード例を次に示します。

C#

Console.WriteLine("Passive: {0}  Keep alive: {1}  Binary: {2} Timeout: {3}.",
 
    request.UsePassive, 
    request.KeepAlive, 
    request.UseBinary,
    request.Timeout == -1 ? "none" : request.Timeout.ToString()
);

プラットフォーム

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