ServicePoint.Expect100Continue プロパティ

定義

名前空間:

System.Net

アセンブリ:

System.Net.ServicePoint.dll

ソース:

ServicePoint.cs

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

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

public bool Expect100Continue { get; set; }

member this.Expect100Continue : bool with get, set

Public Property Expect100Continue As Boolean

プロパティ値

Boolean

POST 要求に対して 100-Continue 応答を見込んでいる場合は true。それ以外の場合は false。 既定値は true です。

例

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

Console::WriteLine( "UseNagleAlgorithm = {0} ", sp->UseNagleAlgorithm.ToString() );
Console::WriteLine( "Expect 100-continue = {0}", sp->Expect100Continue.ToString() );

Console.WriteLine("UseNagleAlgorithm = " + sp.UseNagleAlgorithm.ToString());
Console.WriteLine("Expect 100-continue = " + sp.Expect100Continue.ToString());

Console.WriteLine("UseNagleAlgorithm = " + sp.UseNagleAlgorithm.ToString())
Console.WriteLine("Expect 100-continue = " + sp.Expect100Continue.ToString())

注釈

このプロパティが に true設定されている場合、 メソッドを使用 POST するクライアント要求は、クライアントが投稿するデータを送信する必要があることを示すために、サーバーから 100-Continue 応答を受け取る必要があります。 このメカニズムにより、サーバーが要求ヘッダーに基づいて要求を拒否する場合に、クライアントがネットワーク経由で大量のデータを送信することを回避できます。

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

プロパティが の Expect100Continue 場合、 true要求ヘッダーはサーバーに送信されます。 サーバーが要求を拒否していない場合は、データを送信できることを通知する 100-Continue 応答を送信します。 前の例のように、サーバーが認証を必要とする場合は、401 応答を送信し、クライアントがデータを不必要に送信していません。

このプロパティの値を変更しても、既存の接続には影響しません。 変更後に作成された新しい接続のみが影響を受けます。

Expect 100-Continue 動作については、IETF RFC 2616 セクション 10.1.1 で完全に説明されています。