Compartilhar via


<httpWebRequest> Elemento (Configurações de Rede)

Personaliza os parâmetros de solicitação da Web.

<configuration>
  <system.net>
    <settings>
      <httpWebRequest>

Sintaxe

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

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

Elementos filho

Nenhum.

Elementos pai

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

Observações

Por padrão, o .NET Framework impõe estritamente o RFC 2616 para análise de URI. Algumas respostas do servidor podem incluir caracteres de controle em campos proibidos, o que fará com que o HttpWebRequest.GetResponse() método gere um WebException. Se useUnsafeHeaderParsing for definido como true, HttpWebRequest.GetResponse() não será gerado nesse caso; no entanto, seu aplicativo 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 caracteres de controle.

Arquivos de Configuração

Esse elemento pode ser usado no arquivo de configuração do aplicativo ou no arquivo de configuração do computador (Machine.config).

Example

O exemplo a seguir mostra como especificar um comprimento de cabeçalho máximo maior que o normal.

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

Consulte também