ServicePointManager.Expect100Continue Propriedade

Definição

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.

Aplica-se a

Ver também