ServicePointManager.Expect100Continue Propriedade

Definição

Obtém ou define um valor Boolean que determina se o comportamento 100-Continue é usado.

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 da propriedade

true para habilitar o comportamento 100-Continue. O valor padrão é true.

Exemplos

O exemplo de código a seguir define essa 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;
ServicePointManager.UseNagleAlgorithm = True
ServicePointManager.Expect100Continue = True
ServicePointManager.CheckCertificateRevocationList = True
ServicePointManager.DefaultConnectionLimit = _
    ServicePointManager.DefaultPersistentConnectionLimit

Comentários

Quando essa propriedade é definida como true, o comportamento de 100-Continue é usado. As solicitações de cliente que usam os PUT métodos e POST adicionarão um cabeçalho Expect à solicitação se a Expect100Continue propriedade for true e ContentLength a propriedade for maior que zero ou a SendChunked propriedade for verdadeira. O cliente espera receber uma resposta 100-Continue do servidor para indicar que o cliente deve enviar os dados a serem postados. Esse mecanismo permite que os clientes evitem enviar grandes quantidades de dados pela rede quando o servidor, com base nos cabeçalhos de solicitação, pretende rejeitar a solicitação.

Por exemplo, suponha que a Expect100Continue propriedade seja false. Quando a solicitação é enviada ao servidor, ela inclui os dados. Se, depois de ler os cabeçalhos de solicitação, o servidor exigir autenticação e precisar enviar uma resposta 401, o cliente deverá reenviar os dados com cabeçalhos de autenticação adequados.

Se essa propriedade for true, os cabeçalhos de solicitação serão enviados para o servidor. Se o servidor não rejeitou a solicitação, ele envia uma resposta 100-Continue sinalizando que os dados podem ser transmitidos. Se, como no exemplo anterior, o servidor exigir autenticação, ele enviará a resposta 401 e o cliente não transmitiu desnecessariamente os dados.

Alterar o valor dessa propriedade não afeta os objetos existentes ServicePoint . Somente novos ServicePoint objetos criados após a alteração são afetados.

O comportamento 100-Continue não é usado para solicitações HTTP 1.0 mesmo que essa propriedade esteja definida como true.

O comportamento Expect 100-Continue é totalmente descrito na Seção 10.1.1 do IETF RFC 2616.

Aplica-se a

Confira também