sessionState 的 providers 元素(ASP.NET 设置架构)
更新:2007 年 11 月
包含自定义会话状态存储提供程序的集合。
此元素是 .NET Framework 2.0 版中的新元素。
configuration 元素(常规设置架构)
system.web 元素(ASP.NET 设置架构)
sessionState 元素(ASP.NET 设置架构)
sessionState 的 providers 元素(ASP.NET 设置架构)
<providers>
<add
/>
<remove />
<clear/>
</providers>
属性和元素
下面几部分描述了属性、子元素和父元素。
属性
无。
子元素
元素 |
说明 |
---|---|
Add |
可选的元素。 向会话状态存储提供程序的集合添加提供程序。 |
clear |
可选的元素。 移除所有对继承的会话状态存储提供程序的引用,仅允许由当前 add 元素添加的会话状态存储提供程序。 |
Remove |
可选的元素。 从集合中移除对继承的会话状态存储提供程序的引用。 |
父元素
元素 |
说明 |
---|---|
configuration |
指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素,并且包含各种配置元素,这些配置元素配置 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 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
概念
参考
sessionState 的 providers 的 add 元素(ASP.NET 设置架构)
sessionState 的 providers 的 clear 元素(ASP.NET 设置架构)
sessionState 的 providers 的 remove 元素(ASP.NET 设置架构)
sessionState 的 providers 元素(ASP.NET 设置架构)