sessionState 的 providers 項目 (ASP.NET 設定結構描述)
包含自訂工作階段狀態存放區提供者的集合。
這個項目是 .NET Framework 2.0 版中新增的項目。
<providers>
<add
/>
<remove />
<clear/>
</providers>
屬性和項目
下列各節將說明屬性、子項目和父項目。
屬性
無。
子項目
項目 |
描述 |
---|---|
Add |
選擇性項目。 將提供者加入至工作階段狀態存放區提供者的集合。 |
clear |
選擇性項目。 移除繼承之工作階段狀態存放區提供者的所有參考,只允許由目前的 add 項目所加入的工作階段狀態存放區提供者。 |
Remove |
選擇性項目。 移除集合中繼承工作階段狀態存放區提供者的參考。 |
父項目
項目 |
描述 |
---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。 |
system.web |
指定組態檔中 ASP.NET 組態設定的根項目 (Root Element),並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。 |
sessionState |
設定目前應用程式的工作階段狀態設定。 |
備註
providers 項目包含自訂工作階段狀態存放區提供者的集合。 自訂工作階段狀態存放區提供者必須繼承自 SessionStateStoreProviderBase 類別。
如需存取和修改應用程式程式碼中 sessionState 項目組態值的詳細資訊,請參閱 ProviderSettingsCollection 和 Providers。
預設組態
下列預設 providers 項目不會明確地設定在 Machine.config 檔案或根 Web.config 檔案中。 然而,應用程式傳回的是預設組態。
<sessionState
<!-- Attribute settings. -->
>
<providers>
<clear />
</providers>
</sessionState>
範例
下列程式碼範例中,會顯示如何將 ASP.NET 應用程式的 Web.config 檔案設定為使用自訂工作階段狀態存放區提供者。 如需實作工作階段狀態存放區提供者 (包括範例提供者) 的詳細資訊,請參閱實作工作階段狀態存放區提供者。
<configuration>
<connectionStrings>
<add name="OdbcSessionServices" connectionString="DSN=SessionState;" />
</connectionStrings>
<system.web>
<sessionState
cookieless="true"
regenerateExpiredSessionId="true"
mode="Custom"
customProvider="OdbcSessionProvider">
<providers>
<add name="OdbcSessionProvider"
type="Samples.AspNet.Session.OdbcSessionStateStore"
connectionStringName="OdbcSessionServices"
writeExceptionsToEventLog="false" />
</providers>
</sessionState>
</system.web>
</configuration>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
Machine.config 根層次的 Web.config 應用程式層級的 Web.config |
需求 |
Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
請參閱
工作
參考
sessionState 項目 (ASP.NET 設定結構描述)
sessionState 提供者的 add 項目 (ASP.NET 設定結構描述)
sessionState 提供者的 clear 項目 (ASP.NET 設定結構描述)
sessionState 提供者的 remove 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
sessionState 的 providers 項目 (ASP.NET 設定結構描述)