ServicePointManager.Expect100Continue Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um Boolean valor que determina se o comportamento 100-Continue é utilizado.
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
Valor de Propriedade
true para ativar o comportamento 100-Continue. O valor predefinido é true.
Exemplos
O seguinte exemplo de código define esta propriedade.
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
Observações
Quando esta propriedade está definida para true, é usado o comportamento 100-Continue. Pedidos de cliente que utilizam os PUT métodos e POST adicionam um cabeçalho Expect ao pedido se a Expect100Continue propriedade for true e ContentLength propriedade for maior que zero ou se a SendChunked propriedade for verdadeira. O cliente espera receber uma resposta 100-Continue do servidor a indicar que o cliente deve enviar os dados a serem publicados. Este mecanismo permite aos clientes evitar enviar grandes quantidades de dados pela rede quando o servidor, com base nos cabeçalhos do pedido, pretende rejeitar o pedido.
Por exemplo, assuma que a Expect100Continue propriedade é false. Quando o pedido é enviado ao servidor, inclui os dados. Se, após ler os cabeçalhos do pedido, o servidor exigir autenticação e enviar uma resposta 401, o cliente deve reenviar os dados com cabeçalhos de autenticação adequados.
Se esta propriedade for true, os cabeçalhos do pedido são enviados para o servidor. Se o servidor não tiver rejeitado o pedido, envia uma resposta 100-Continue a sinalizar que os dados podem ser transmitidos. Se, como no exemplo anterior, o servidor exigir autenticação, envia a resposta 401 e o cliente não transmitiu os dados desnecessariamente.
Alterar o valor desta propriedade não afeta os objetos existentes ServicePoint . Apenas os novos ServicePoint objetos criados após a alteração são afetados.
O comportamento 100-Continue não é usado para pedidos HTTP 1.0 mesmo que esta propriedade esteja definida para true.
O comportamento Expect 100-Continue está totalmente descrito na Secção 10.1.1 do IETF RFC 2616.
Note
Desde .NET 9, esta propriedade define HttpRequestHeaders.ExpectContinue no HttpRequestMessage.Headers a menos que seja sobreposta por ServicePoint.Expect100Continue.