webRequestModules 的 <add> 元素(网络设置)

将自定义 Web 请求模块添加到应用程序。

configuration
  <system.net>
    <webRequestModules>
      <add>

语法

<add
  prefix="URI prefix"
  type="type_fullname, assembly_fullname"
/>  

特性和元素

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

特性

Attribute 说明
prefix 此 Web 请求模块处理的请求的 URI 前缀。
type 完全限定类型名称(由 FullName 属性指示)和程序集名称(由 FullName 属性指示),以逗号分隔开,用于实现此 Web 请求模块。

子元素

无。

父元素

元素 说明
webRequestModules 指定用于从网络主机请求信息的模块。

备注

prefix 特性定义使用指定 Web 请求模块的 URI 前缀。 通常注册 Web 请求模块用来处理特定协议(如 HTTP 或 FTP),但也可以注册它来处理对服务器上特定服务器或路径的请求。

当 URI 匹配的前缀传递到 WebRequest.Create 方法时,将创建 Web 请求模块。

prefix 特性的值应为有效 URI 的前导字符。  例如 httphttp://www.contoso.com

type 特性的值应为有效的类型名称和相应的程序集名称,并用逗号分隔开。

配置文件

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

示例

下面的示例向 HTTP 注册自定义 Web 请求模块。 你应该将 Version 和 PublicKeyToken 的值替换为指定模块的正确值。

<configuration>  
  <system.net>  
    <webRequestModules>  
      <add prefix="http"  
           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,  
           Culture=neutral, PublicKeyToken=b77a5c561934e089"  
      />  
    </webRequestModules>  
  </system.net>  
</configuration>  

另请参阅