<httpWebRequest> 元素(网络设置)

自定义 Web 请求参数。

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

语法

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

特性和元素

下列各节描述了特性、子元素和父元素。

特性

Attribute 说明
maximumResponseHeadersLength 指定响应头的最大长度(以 KB 为单位)。 默认值为 64。 值为 -1 表示不会对响应头施加大小限制。
maximumErrorResponseLength 指定错误响应的最大长度(以 KB 为单位)。 默认值为 64。 值为 -1 表示不会对错误响应施加大小限制。
maximumUnauthorizedUploadLength 指定响应未授权错误代码的上传的最大长度(以字节为单位)。 默认值为 -1。 值 -1 表示没有对上载施加大小限制。
useUnsafeHeaderParsing 指定是否启用不安全标头分析。 默认值为 false

子元素

无。

父元素

元素 说明
设置 配置 System.Net 命名空间的基本网络选项。

备注

默认情况下,.NET Framework 严格执行 RFC 2616 进行 URI 解析。 某些服务器响应可能在禁止的字段中包含控制字符,这将导致 HttpWebRequest.GetResponse() 方法引发 WebException。 如果将 useUnsafeHeaderParsing 设置为 true,在这种情况下不会引发 HttpWebRequest.GetResponse(),但应用程序容易受到多种形式的 URI 分析攻击。 最佳解决方案是更改服务器,使响应不包含控制字符。

配置文件

此元素可在应用程序配置文件或计算机配置文件 (Machine.config) 中使用。

示例

下面的示例演示如何指定比一般最长标头大的长度。

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

请参阅