ServicePoint.ConnectionLeaseTimeout プロパティ

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

ServicePoint.ConnectionLeaseTimeout プロパティ

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

アクティブな ServicePoint 接続が閉じられるまでのミリ秒単位の時間を取得または設定します。

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

Visual Basic (宣言)

Public Property ConnectionLeaseTimeout As
 Integer

Visual Basic (使用法)

Dim instance As ServicePoint
Dim value As Integer

value = instance.ConnectionLeaseTimeout

instance.ConnectionLeaseTimeout = value

C#

public int ConnectionLeaseTimeout { get;
 set; }

C++

public:
property int ConnectionLeaseTimeout {
    int get ();
    void set (int value);
}

J#

/** @property */
public int get_ConnectionLeaseTimeout ()

/** @property */
public void set_ConnectionLeaseTimeout (int
 value)

JScript

public function get ConnectionLeaseTimeout
 () : int

public function set ConnectionLeaseTimeout
 (value : int)

プロパティ値
アクティブな ServicePoint 接続が開いている時間をミリ秒単位で指定する Int32。既定値は -1 で、アクティブな ServicePoint 接続を無制限に開いておくことができます。要求の処理後に強制的に ServicePoint 接続を閉じるには、このプロパティを 0 に設定します。

例外

例外の種類	条件
ArgumentOutOfRangeException	設定操作として指定された値が -1 未満の負数です。

解説

このプロパティを使用して、ServicePoint オブジェクトのアクティブな接続が無制限に開いたままにならないようにできます。このプロパティは、負荷分散を行う場合など、定期的に接続を切断して再確立する必要がある場合用に用意されています。

既定では、要求の KeepAlive が true である場合、MaxIdleTime プロパティで、アクティブでない場合に ServicePoint 接続を閉じるためのタイムアウトを設定します。ServicePoint にアクティブな接続がある場合、MaxIdleTime は無効で、接続は無制限に開かれたままになります。

ConnectionLeaseTimeout プロパティが -1 以外の値に設定されている場合、指定した時間が経過すると、要求の処理後に、その要求の KeepAlive を false に設定することによって、アクティブな ServicePoint 接続が閉じられます。

この値を設定すると、ServicePoint オブジェクトが管理しているすべての接続に影響します。

使用例

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

プラットフォーム

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ServicePoint クラス
ServicePoint メンバ
System.Net 名前空間
HttpWebRequest.KeepAlive プロパティ
KeepAlive
HttpListenerRequest.KeepAlive プロパティ