ServicePoint.Expect100Continue 属性

定义

命名空间:

System.Net

程序集:

System.Net.ServicePoint.dll

Source:

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 个持续响应;否则，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”行为。