httpModules 項目 (ASP.NET 設定結構描述)
更新：2007 年 11 月
設定應用程式中的 HTTP 模組。可以在組態階層架構中的任何層級宣告這個項目。
<configuration> 項目
system.web 項目 (ASP.NET 設定結構描述)
httpModules 項目 (ASP.NET 設定結構描述)
<httpModules> <add... /> <remove... /> <clear/> </httpModules>
屬性和項目
下列小節描述屬性、子項目和父項目。
屬性
無。
子項目
項目 |
描述 |
|---|---|
add |
選擇性項目。 將 httpModules 項目加入至應用程式。 |
clear |
選擇性項目。 移除應用程式的所有 httpModules 項目。 |
remove |
選擇性項目。 移除 httpModules 項目的參考。 值必須完全符合先前 add 指示詞的值。 |
父項目
項目 |
描述 |
|---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。 |
system.web |
指定 ASP.NET 組態區段的根項目。 |
備註
預設的組態
下列預設 httpModules 項目是在 .NET Framework 1.1 版中的 Machine.config 檔案中設定。
<httpModules>
<add name="OutputCache" type="System.Web.Caching.OutputCacheModule"/>
<add name="Session" type="System.Web.SessionState.SessionStateModule"/>
<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule"/>
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule"/>
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule"/>
<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule"/>
<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule"/>
<add name="ErrorHandlerModule" type="System.Web.Mobile.ErrorHandlerModule, System.Web.Mobile,
Version=1.0.5000.0, Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a"/>
</httpModules>
下列預設 httpModules 項目是在 .NET Framework 1.0 版中的 Machine.config 檔案中設定。
<httpModules>
<add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
<add name="Session" type="System.Web.SessionState.SessionStateModule" />
<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />
</httpModules>
下列預設的 httpModules 項目是在 .NET Framework 2.0 版中的根 Web.config 檔中設定。
<httpModules>
<add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
<add name="Session" type="System.Web.SessionState.SessionStateModule" />
<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
<add name="RoleManager" type="System.Web.Security.RoleManagerModule" />
<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />
<add name="AnonymousIdentification" type="System.Web.Security.AnonymousIdentificationModule" />
<add name="Profile" type="System.Web.Profile.ProfileModule" />
</httpModules>
範例
下列程式碼範例示範如何將三個 HttpModule 參考加入至 ASP.NET 應用程式。
<configuration>
<system.web>
<httpModules>
<add type="System.Web.Caching.OutputCacheModule"
name="OutputCache"/>
<add type="System.Web.SessionState.SessionStateModule"
name="Session"/>
<add type=Selector, selector.dll"
name="Selector"/>
</httpModules>
</system.web>
</configuration>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
Machine.config 根層次的 Web.config 應用程式層級的 Web.config 虛擬或實體目錄層級的 Web.config |
需求 |
Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 1.0、1.1 或 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
請參閱
工作
概念
參考
system.web 項目 (ASP.NET 設定結構描述)
httpModules 的 add 項目 (ASP.NET 設定結構描述)
httpModules 的 clear 項目 (ASP.NET 設定結構描述)
httpModules 的 remove 項目 (ASP.NET 設定結構描述)