ServicePoint.Expect100Continue Property

Gets or sets a Boolean value that determines whether 100-Continue behavior is used.

Namespace: System.Net
Assembly: System (in system.dll)

public bool Expect100Continue { get; set; }
/** @property */
public boolean get_Expect100Continue ()

/** @property */
public void set_Expect100Continue (boolean value)

public function get Expect100Continue () : boolean

public function set Expect100Continue (value : boolean)

Not applicable.

Property Value

true to expect 100-Continue responses for POST requests; otherwise, false. The default value is true.

When this property is set to true, client requests that use the POST method expect to receive a 100-Continue response from the server to indicate that the client should send the data to be posted. This mechanism allows clients to avoid sending large amounts of data over the network when the server, based on the request headers, intends to reject the request.

For example, assume the Expect100Continue property is false. When the request is sent to the server, it includes the data. If, after reading the request headers, the server requires authentication and sends a 401 response, the client must resend the data with proper authentication headers.

If the Expect100Continue property is true, the request headers are sent to the server. If the server has not rejected the request, it sends a 100-Continue response signaling that the data can be transmitted. If, as in the preceding example, the server requires authentication, it sends the 401 response and the client has not unnecessarily transmitted the data.

Changing the value of this property does not affect existing connections. Only new connections created after the change are affected.

The Expect 100-Continue behavior is fully described in IETF RFC 2616 Section 10.1.1.

The following code example displays the value of this property.

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

Console.WriteLine(("UseNagleAlgorithm = " 
    + System.Convert.ToString(sp.get_UseNagleAlgorithm())));
Console.WriteLine(("Expect 100-continue = " 
    + System.Convert.ToString(sp.get_Expect100Continue())));

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1

.NET Compact Framework

Supported in: 2.0