Udostępnij za pośrednictwem

<httpWebRequest> , element (ustawienia sieci)

  • Artykuł

Dostosowuje parametry żądania sieci Web.

<Konfiguracji>
  <system.net>
    <Ustawienia>
      <httpWebRequest>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut Opis
maximumResponseHeadersLength Określa maksymalną długość nagłówka odpowiedzi w kilobajtach. Wartość domyślna to 64. Wartość -1 wskazuje, że żaden limit rozmiaru nie zostanie nałożony na nagłówki odpowiedzi.
maximumErrorResponseLength Określa maksymalną długość odpowiedzi błędu w kilobajtach. Wartość domyślna to 64. Wartość -1 wskazuje, że na odpowiedź o błędzie nie zostanie nałożony żaden limit rozmiaru.
maximumUnauthorizedUploadLength Określa maksymalną długość przekazywania w odpowiedzi na nieautoryzowany kod błędu w bajtach. Wartość domyślna to -1. Wartość -1 wskazuje, że na przekazywanie nie zostanie nałożony żaden limit rozmiaru.
useUnsafeHeaderParsing Określa, czy niebezpieczne analizowanie nagłówków jest włączone. Wartość domyślna to false.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element Opis
ustawienia Konfiguruje podstawowe opcje sieci dla System.Net przestrzeni nazw.

Uwagi

Domyślnie .NET Framework ściśle wymusza analizowanie identyfikatorów URI RFC 2616. Niektóre odpowiedzi serwera mogą zawierać znaki sterujące w niedozwolonych polach, co spowoduje HttpWebRequest.GetResponse() , że metoda zgłosi błąd WebException. Jeśli parametr useUnsafeHeaderParsing ma wartość true, HttpWebRequest.GetResponse() nie zostanie zgłoszony w tym przypadku, jednak aplikacja będzie podatna na kilka form ataków analizowania identyfikatorów URI. Najlepszym rozwiązaniem jest zmiana serwera tak, aby odpowiedź nie zawierała znaków sterujących.

Pliki konfiguracji

Ten element może być używany w pliku konfiguracji aplikacji lub pliku konfiguracji maszyny (Machine.config).

Przykład

W poniższym przykładzie pokazano, jak określić większą niż normalną maksymalną długość nagłówka.

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

Zobacz też