ServicePoint.Expect100Continue 屬性

定義

命名空間:

System.Net

組件:

System.Net.ServicePoint.dll

來源:

ServicePoint.cs

取得或設定 Boolean 值，判斷是否使用 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

屬性值

Boolean

true 預期 POST 要求的 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())

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

當此屬性設定為 true時，使用 POST 方法的用戶端要求預期會從伺服器接收 100-Continue 回應，以指出客戶端應該傳送要張貼的數據。 此機制可讓用戶端避免在伺服器根據要求標頭來拒絕要求時，透過網路傳送大量數據。

例如，假設 Expect100Continue 屬性是 false。 當要求傳送至伺服器時，它會包含數據。 如果在讀取要求標頭之後，伺服器需要驗證並傳送 401 回應，用戶端就必須以適當的驗證標頭重新傳送數據。

如果 Expect100Continue 屬性是 true，則會將要求標頭傳送至伺服器。 如果伺服器尚未拒絕要求，則會傳送 100-Continue 回應訊號，指出可以傳輸數據。 如果如上述範例所示，伺服器需要驗證，則會傳送 401 回應，而且客戶端並未不必要地傳輸數據。

變更這個屬性的值不會影響現有的連接。 只有變更之後建立的新連線才會受到影響。

IETF RFC 2616 第 10.1.1 節會完整描述預期 100-Continue 行為。