webRequestModules 的 <add> 元素 (網路設定)

將自訂 Web 要求模組新增至應用程式。

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

Syntax

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

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

Attribute 說明
prefix 此 Web 要求模組所處理要求的 URI 前置詞。
type 完整類型名稱 (由 FullName 屬性表示) 與實作此 Web 要求模組並以逗號分隔的組件名稱 (由 FullName 屬性表示)。

子元素

無。

父項目

Element 說明
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>  

另請參閱