ServicePoint.Expect100Continue Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.ServicePoint.dll

Zdroj:

ServicePoint.cs

Získá nebo nastaví Boolean hodnotu, která určuje, zda je použito chování 100-Continue.

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

Hodnota vlastnosti

Boolean

true očekávat 100 odpovědí na žádosti o POST; jinak false. Výchozí hodnota je true.

Příklady

Následující příklad kódu zobrazí hodnotu této vlastnosti.

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())

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Pokud je tato vlastnost nastavena na true, klient požadavky, které používají metodu POST očekává, že od serveru obdrží odpověď 100-Continue, která indikuje, že klient by měl odesílat data, která mají být odeslána. Tento mechanismus umožňuje klientům zabránit odesílání velkých objemů dat přes síť, když server na základě hlaviček požadavků hodlá požadavek odmítnout.

Předpokládejme například, že vlastnost Expect100Continue je false. Když se požadavek odešle na server, obsahuje data. Pokud server po přečtení hlaviček požadavku vyžaduje ověření a odešle odpověď 401, klient musí data znovu odeslat se správnými hlavičkami ověřování.

Pokud je vlastnost Expect100Continuetrue, hlavičky požadavku se odešlou na server. Pokud server požadavek neodmítl, odešle 100-Continue response signaling that the data can be sended. Pokud server stejně jako v předchozím příkladu vyžaduje ověření, odešle odpověď 401 a klient zbytečně nepřenesl data.

Změna hodnoty této vlastnosti nemá vliv na existující připojení. Ovlivněna budou pouze nová připojení vytvořená po změně.

Chování Expect 100-Continue je plně popsáno v dokumentu IETF RFC 2616 Oddíl 10.1.1.