ServicePointManager.Expect100Continue Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, определяющее Boolean , используется ли поведение 100-Continue.
public:
static property bool Expect100Continue { bool get(); void set(bool value); };
public static bool Expect100Continue { get; set; }
static member Expect100Continue : bool with get, set
Public Shared Property Expect100Continue As Boolean
Значение свойства
true для включения поведения 100-Continue. Значение по умолчанию — true.
Примеры
Следующий пример кода задает это свойство.
ServicePointManager.UseNagleAlgorithm = true;
ServicePointManager.Expect100Continue = true;
ServicePointManager.CheckCertificateRevocationList = true;
ServicePointManager.DefaultConnectionLimit = ServicePointManager.DefaultPersistentConnectionLimit;
ServicePointManager.UseNagleAlgorithm = True
ServicePointManager.Expect100Continue = True
ServicePointManager.CheckCertificateRevocationList = True
ServicePointManager.DefaultConnectionLimit = _
ServicePointManager.DefaultPersistentConnectionLimit
Комментарии
Если для этого свойства задано trueзначение , используется поведение 100-Continue. Клиентские запросы, использующие PUT методы, POST добавляют заголовок Expect в запрос, если Expect100Continue свойство ContentLengthtrue больше нуля или SendChunked свойство имеет значение true. Клиент будет ожидать получения ответа 100-Continue от сервера, чтобы указать, что клиент должен отправлять данные для публикации. Этот механизм позволяет клиентам избежать отправки больших объемов данных через сеть, когда сервер, основанный на заголовках запросов, намерен отклонить запрос.
Например, предположим Expect100Continue , что свойство имеет значение false. Когда запрос отправляется серверу, он содержит данные. Если после чтения заголовков запроса сервер требует проверки подлинности и должен отправить ответ 401, клиент должен повторно отправить данные с соответствующими заголовками проверки подлинности.
Если это свойство имеет значение true, заголовки запросов отправляются на сервер. Если сервер не отклонил запрос, он отправляет ответ 100-Continue, указывающий на передачу данных. Если, как и в предыдущем примере, серверу требуется проверка подлинности, он отправляет ответ 401, а клиент не передает данные без необходимости.
Изменение значения этого свойства не влияет на существующие ServicePoint объекты. Затронуты только новые ServicePoint объекты, созданные после изменения.
Поведение 100-Continue не используется для запросов HTTP 1.0, даже если для этого свойства задано trueзначение.
Поведение "Ожидание 100-Продолжить" полностью описано в разделе IETF RFC 2616 10.1.1.
Замечание
Начиная с .NET 9, это свойство задает HttpRequestHeaders.ExpectContinue значение для HttpRequestMessage.Headers нее, если не переопределено ServicePoint.Expect100Continue.