ServicePoint.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:
property bool Expect100Continue { bool get(); void set(bool value); };public bool Expect100Continue { get; set; }member this.Expect100Continue : bool with get, setPublic Property Expect100Continue As BooleanValor de Propriedade
true esperar respostas 100-Continue para POST pedidos; caso contrário, false. O valor predefinido é true.
Exemplos
O seguinte exemplo de código mostra o valor desta propriedade.
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())
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Quando esta propriedade é definida para true, os pedidos do cliente que utilizam o POST método esperam receber uma resposta 100-Continue do servidor para 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 a Expect100Continue propriedade for true, os cabeçalhos de 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 as ligações existentes. Apenas as novas ligações criadas após a mudança são afetadas.
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.