<httpWebRequest> 要素 (ネットワーク設定)

  • [アーティクル]

Web 要求パラメーターをカスタマイズします。

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

構文

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
maximumResponseHeadersLength 応答ヘッダーの最大長をキロバイト単位で指定します。 既定値は、64 です。 値 -1 は、応答ヘッダーにサイズ制限が適用されないことを示します。
maximumErrorResponseLength エラー応答の最大長をキロバイト単位で指定します。 既定値は、64 です。 値 -1 は、エラー応答にサイズ制限が適用されないことを示します。
maximumUnauthorizedUploadLength 未承認のエラー コードへの応答としてのアップロード情報の最大長をバイト単位で指定します。 既定値は -1 です。 値 -1 は、アップロード情報にサイズ制限が適用されないことを示します。
useUnsafeHeaderParsing 安全ではないヘッダーの解析が有効かどうかを指定します。 既定値は false です。

子要素

なし。

親要素

要素 説明
設定 System.Net 名前空間の基本的なネットワーク オプションを構成します。

解説

既定では、.NET Framework では、URI 解析に RFC 2616 が厳密に適用されます。 一部のサーバー応答には、禁止フィールドに制御文字が含まれることがあります。それにより HttpWebRequest.GetResponse() メソッドで WebException がスローされます。 useUnsafeHeaderParsing が true に設定されている場合、HttpWebRequest.GetResponse() はこの場合、スローしません。ただし、いくつかの形態の URI 解析攻撃に対してアプリケーションが脆弱になります。 最良の解決策は、応答に制御文字が含まれないようにサーバーを変更することです。

構成ファイル

この要素は、アプリケーション構成ファイルまたはマシン構成ファイル (Machine.config) で使用できます。

例

次の例からは、通常の最大ヘッダー長より大きい値を指定する方法を確認できます。

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

関連項目