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

Artigo
05/09/2023

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

<configuration>
  <system.net>
    <configurações>
      <httpWebRequest>

Syntax

<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.

Atributos

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

Element	Descrição
configurações	Configura as opções de rede básicaspara o namespace System.Net.

Comentários

Por padrão, o .NET Framework impõe estritamente o RFC 2616 para análise de URI. Algumas respostas de 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á lançado 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).

Exemplo

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>

Compartilhar via