ServicePoint.Expect100Continue Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor Boolean que determina se o comportamento 100-Continue é usado.
public:
property bool Expect100Continue { bool get(); void set(bool value); };
public bool Expect100Continue { get; set; }
member this.Expect100Continue : bool with get, set
Public Property Expect100Continue As Boolean
Valor da propriedade
true
esperar respostas 100-Continue para solicitações de POST
; caso contrário, false
. O valor padrão é true
.
Exemplos
O exemplo de código a seguir exibe o valor dessa propriedade.
Console::WriteLine( "UseNagleAlgorithm = {0} ", sp->UseNagleAlgorithm.ToString() );
Console::WriteLine( "Expect 100-continue = {0}", sp->Expect100Continue.ToString() );
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())
Comentários
Cuidado
WebRequest
, HttpWebRequest
, ServicePoint
e WebClient
estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.
Quando essa propriedade é definida como true
, as solicitações de cliente que usam o método POST
esperam 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 da solicitação, pretende rejeitar a solicitação.
Por exemplo, suponha que a propriedade Expect100Continue 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 enviar uma resposta 401, o cliente deverá reenviar os dados com cabeçalhos de autenticação adequados.
Se a propriedade Expect100Continue 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 as conexões existentes. Somente novas conexões criadas após a alteração são afetadas.
O comportamento Expect 100-Continue é totalmente descrito na Seção 10.1.1 do IETF RFC 2616.