sessionState 提供者的 add 項目 (ASP.NET 設定結構描述)
將提供者加入至工作階段狀態存放區提供者的集合。
<add
name="provider name"
type="fully qualified type reference"
/>
屬性和項目
下列章節會說明屬性 (Attribute)、子項目和父項目。
屬性
屬性 |
描述 |
|---|---|
name |
必要的 String 屬性。 指定提供者執行個體的名稱。 sessionState 項目的模式屬性設定為 Custom 時，這個值會用於 sessionState 項目的 customProvider 屬性，將提供者執行個體識別為工作階段狀態存放區提供者。 |
type |
必要的 String 屬性。 指定正在實作 SessionStateStoreProviderBase 抽象基底類別的型別。 值必須是組件的完整參考。 |
子項目
無。
父項目
項目 |
描述 |
|---|---|
configuration |
需要 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。 |
system.web |
指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。 |
sessionState |
設定目前應用程式的工作階段狀態設定。 |
providers |
包含自訂工作階段狀態存放區提供者的集合。 |
備註
add 項目會將提供者加入至 providers 項目中工作階段狀態存放區提供者的集合。 providers 項目包含自訂工作階段狀態存放區提供者的集合。 自訂工作階段狀態存放區提供者必須繼承自 SessionStateStoreProviderBase 類別。
如需如何存取和修改應用程式程式碼中 sessionState 項目之組態值的詳細資訊，請參閱 ProviderSettingsCollection 和 Providers。
範例
下列程式碼範例示範如何使用 ASP.NET 應用程式的 Web.config 檔，將其設定為使用自訂工作階段狀態存放區提供者。 如需如何實作工作階段狀態存放區提供者 (包括範例提供者) 的詳細資訊，請參閱Implementing a Session State Store Provider。
<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 版 Microsoft .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
請參閱
工作
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
參考
sessionState 的 providers 項目 (ASP.NET 設定結構描述)
sessionState 提供者的 clear 項目 (ASP.NET 設定結構描述)
sessionState 提供者的 remove 項目 (ASP.NET 設定結構描述)
sessionState 的 providers 項目 (ASP.NET 設定結構描述)
sessionState 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
概念
Implementing a Session-State Store Provider
ASP.NET Configuration File Hierarchy