ServicePoint.Expect100Continue Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение 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
Значение свойства
true
ожидать 100-продолжить ответы на запросы 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())
Комментарии
Осторожность
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Если для этого свойства задано значение true
, клиентские запросы, использующие метод POST
, ожидают получения ответа 100-Continue от сервера, чтобы указать, что клиент должен отправлять данные для публикации. Этот механизм позволяет клиентам избежать отправки больших объемов данных через сеть, когда сервер, основанный на заголовках запросов, намерен отклонить запрос.
Например, предположим, что свойство Expect100Continue является false
. Когда запрос отправляется серверу, он содержит данные. Если после чтения заголовков запроса сервер требует проверки подлинности и отправляет ответ 401, клиент должен повторно отправить данные с соответствующими заголовками проверки подлинности.
Если свойство Expect100Continuetrue
, заголовки запросов отправляются на сервер. Если сервер не отклонил запрос, он отправляет ответ 100-Continue, указывающий на передачу данных. Если, как и в предыдущем примере, серверу требуется проверка подлинности, он отправляет ответ 401, а клиент не передает данные без необходимости.
Изменение значения этого свойства не влияет на существующие подключения. Только новые подключения, созданные после изменения, будут затронуты.
Поведение "Ожидание 100-Продолжить" полностью описано в разделе IETF RFC 2616 10.1.1.