ServicePoint.Expect100Continue プロパティ

定義

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

プロパティ値

truePOST 要求に対して 100 -Continue 応答が期待されます。それ以外の場合は、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())

注釈

注意

WebRequestHttpWebRequestServicePointWebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

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

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

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

適用対象