ServicePointManager.Expect100Continue プロパティ

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

ServicePointManager.Expect100Continue プロパティ

100-Continue 動作を使用するかどうかを決定する Boolean 値を取得または設定します。

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

Visual Basic (宣言)

Public Shared Property Expect100Continue
 As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = ServicePointManager.Expect100Continue

ServicePointManager.Expect100Continue = value

C#

public static bool Expect100Continue
 { get; set; }

C++

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

J#

/** @property */
public static boolean get_Expect100Continue
 ()

/** @property */
public static void set_Expect100Continue
 (boolean value)

JScript

public static function get
 Expect100Continue () : boolean

public static function set
 Expect100Continue (value : boolean)

プロパティ値
POST 要求に対して 100-Continue 応答を期待する場合は true。それ以外の場合は false。既定値は true です。

解説

このプロパティを true に設定した場合、POST メソッドを使用するクライアント要求は、サーバーから 100-Continue 応答が送信されるまで待機し、ポストするデータの送信はその応答の後に行われます。これにより、サーバーが要求のヘッダーに基づいて要求を拒否する場合に、大量のデータがクライアントからネットワークを通じて無駄に送信されることを避けることができます。

たとえば、Expect100Continue プロパティを false にしたとします。その場合、サーバーに要求が送信される際には、データも一緒に送信されます。要求のヘッダーが読み取られた後、サーバーが認証を要求し、401 応答を送信した場合、クライアントは適切な認証ヘッダーを付けてデータを再送信する必要があります。

一方、このプロパティが true である場合は、まず要求ヘッダーだけがサーバーに送信されます。サーバーが要求を拒否しなければ、100-Continue 応答によってデータの送信が許可されます。前述の例のように、サーバーによって認証が要求され、401 応答が返された場合でも、その時点ではデータはまだクライアントから送信されていないので、無駄な通信は発生しません。

このプロパティの値を変更しても、既存の ServicePoint オブジェクトには影響しません。変更後に作成された新しい ServicePoint オブジェクトだけに影響します。

Expect 100-Continue 機能の詳細については、IETF RFC 2616 Section 10.1.1 を参照してください。

使用例

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

Visual Basic

ServicePointManager.UseNagleAlgorithm = True
ServicePointManager.Expect100Continue = True
ServicePointManager.CheckCertificateRevocationList = True
ServicePointManager.DefaultConnectionLimit = _
    ServicePointManager.DefaultPersistentConnectionLimit

C#

ServicePointManager.UseNagleAlgorithm = true;
ServicePointManager.Expect100Continue = true;
ServicePointManager.CheckCertificateRevocationList = true;
ServicePointManager.DefaultConnectionLimit = ServicePointManager.DefaultPersistentConnectionLimit;

C++

ServicePointManager::UseNagleAlgorithm = true;
ServicePointManager::Expect100Continue = true;
ServicePointManager::CheckCertificateRevocationList = true;
ServicePointManager::DefaultConnectionLimit = ServicePointManager::DefaultPersistentConnectionLimit;

J#

ServicePointManager.set_UseNagleAlgorithm(true);
ServicePointManager.set_Expect100Continue(true);
ServicePointManager.set_CheckCertificateRevocationList(true);
ServicePointManager.set_DefaultConnectionLimit(
    ServicePointManager.DefaultPersistentConnectionLimit);

プラットフォーム

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、1.1
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
ServicePointManager クラス
ServicePointManager メンバ
System.Net 名前空間