<HttpWebRequest Element (Network Settings) (Elemento httpWebRequest> [Definições de Rede])

Artigo
05/09/2023

Personaliza os parâmetros do pedido Web.

<configuração>
  <system.net>
    <definições>
      <httpWebRequest>

Syntax

<httpWebRequest  
  maximumResponseHeadersLength="size"  
  maximumErrorResponseLength="size"  
  maximumUnauthorizedUploadLength="size"  
  useUnsafeHeaderParsing="true|false"  
/>

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`maximumResponseHeadersLength`	Especifica o comprimento máximo de um cabeçalho de resposta, em kilobytes. A predefinição é 64. Um valor de -1 indica que não será imposto nenhum limite de tamanho aos cabeçalhos de resposta.
`maximumErrorResponseLength`	Especifica o comprimento máximo de uma resposta de erro, em quilobytes. A predefinição é 64. Um valor de -1 indica que não será imposto nenhum limite de tamanho à resposta do erro.
`maximumUnauthorizedUploadLength`	Especifica o comprimento máximo de um carregamento em resposta a um código de erro não autorizado, em bytes. A predefinição é -1. Um valor de -1 indica que não será imposto nenhum limite de tamanho no carregamento.
`useUnsafeHeaderParsing`	Especifica se a análise de cabeçalhos não segura está ativada. O valor predefinido é `false`.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento	Descrição
definições	Configura as opções de rede básicas para o System.Net espaço de nomes.

Observações

Por predefinição, o .NET Framework impõe estritamente RFC 2616 para análise de URI. Algumas respostas do servidor podem incluir carateres de controlo em campos proibidos, o que fará com que o HttpWebRequest.GetResponse() método lance um WebException. Se useUnsafeHeaderParsing estiver definido como verdadeiro, HttpWebRequest.GetResponse() não gerará este caso; no entanto, a sua aplicação ficará vulnerável a várias formas de ataques de análise de URI. A melhor solução é alterar o servidor para que a resposta não inclua carateres de controlo.

Ficheiros de Configuração

Este elemento pode ser utilizado no ficheiro de configuração da aplicação ou no ficheiro de configuração do computador (Machine.config).

Exemplo

O exemplo seguinte mostra como especificar um comprimento de cabeçalho máximo superior ao normal.

<configuration>  
  <system.net>  
    <settings>  
      <httpWebRequest  
        maximumResponseHeadersLength="128"  
      />  
    </settings>  
  </system.net>  
</configuration>

Partilhar via