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 要求有 100-Continue 的回應，則為 POST，否則為 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 回應，而且用戶端尚未不必要地傳輸數據。

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

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