Elemento <httpWebRequest> (Impostazioni di rete)

Articolo
08/11/2011

Personalizza i parametri delle richieste Web.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
maximumResponseHeadersLength	Specifica la lunghezza massima, in kilobyte, di un'intestazione di risposta. Il valore predefinito è 64. Il valore -1 indica che non verrà imposto alcun limite di dimensione sulle intestazioni di risposta.
maximumErrorResponseLength	Specifica la lunghezza massima, in kilobyte, di una risposta di errore. Il valore predefinito è 64. Il valore -1 indica che non verrà imposto alcun limite di dimensione sulle risposte di errore.
maximumUnauthorizedUploadLength	Specifica la lunghezza massima, in byte, di un caricamento eseguito in risposta a un codice di errore non autorizzato. Il valore predefinito è -1. Un valore di -1 indica che non verrà imposto alcun limite di dimensione all'upload.
useUnsafeHeaderParsing	Specifica se l'analisi delle intestazioni non protette è attivata. Il valore predefinito è false.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
<settings>	Configura opzioni di rete di base per lo spazio dei nomi System.Net.

Note

Per impostazione predefinita, .NET Framework applica in maniera rigida la specifica RFC 2616 per l'analisi URI. Alcune risposte del server possono includere caratteri di controllo in campi non consentiti, che causeranno la generazione di un'eccezione WebException da parte del metodo HttpWebRequest.GetResponse(). Se l'attributo useUnsafeHeaderParsing è impostato su true, il metodo HttpWebRequest.GetResponse() non genererà alcuna eccezione. L'applicazione sarà, tuttavia, vulnerabile a diverse forme di attacchi durante l'analisi URI. La soluzione migliore consiste nel modificare le impostazioni del server in modo che la risposta non includa caratteri di controllo.

File di configurazione

L'elemento può essere utilizzato nel file di configurazione dell'applicazione o nel file di configurazione del computer (Machine.config).

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come specificare una lunghezza di intestazione massima maggiore del normale.

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

Vedere anche

Riferimenti

Schema delle impostazioni di rete

MaximumResponseHeadersLength

Condividi tramite