sessionState 的 providers 的 add 元素（ASP.NET 设置架构）


<add name="provider name" type="fully qualified type reference" />

下面几部分描述了属性、子元素和父元素。

属性

属性	说明
name	必选的 String 属性。指定提供程序实例的名称。当 sessionState 元素的 mode 属性设置为 Custom 值时，sessionState 元素的 customProvider 属性使用该值将提供程序实例标识为会话状态存储提供程序。
type	必选的 String 属性。指定实现 SessionStateStoreProviderBase 抽象基类的类型。该值必须是对程序集的完全限定引用。

说明

name

必选的 String 属性。

指定提供程序实例的名称。当 sessionState 元素的 mode 属性设置为 Custom 值时，sessionState 元素的 customProvider 属性使用该值将提供程序实例标识为会话状态存储提供程序。

type

必选的 String 属性。

指定实现 SessionStateStoreProviderBase 抽象基类的类型。

该值必须是对程序集的完全限定引用。

子元素

无。

父元素

元素	说明
configuration	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
system.web	指定配置文件中 ASP.NET 配置设置的根元素，并且包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。
sessionState	为当前应用程序配置会话状态设置。
providers	包含自定义会话状态存储提供程序的集合。

add 元素向 providers 元素中的会话状态存储提供程序集合添加提供程序。providers 元素包含一个自定义会话状态存储提供程序的集合。自定义会话状态存储提供程序必须从 SessionStateStoreProviderBase 类继承。

有关如何访问和修改应用程序代码中 sessionState 元素的配置值的信息，请参见 ProviderSettingsCollection 和 Providers 类。

下面的代码示例演示如何使用 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>

?

复制代码

<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>

配置节处理程序	SessionStateSection
配置成员	Providers
可配置的位置	Machine.config 根级别的 Web.config 应用程序级别的 Web.config
要求	Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 Microsoft .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005

任务

如何：使用位置设置配置特定目录
如何：锁定 ASP.NET 配置设置

参考

sessionState 的 providers 元素（ASP.NET 设置架构）
sessionState 的 providers 的 clear 元素（ASP.NET 设置架构）
sessionState 的 providers 的 remove 元素（ASP.NET 设置架构）
sessionState 的 providers 元素（ASP.NET 设置架构）
sessionState 元素（ASP.NET 设置架构）
system.web 元素（ASP.NET 设置架构）
configuration 元素（常规设置架构）
System.Configuration
System.Web.Configuration
SessionStateSection
ProviderSettingsCollection
Providers
SessionStateStoreProviderBase

概念

实现会话状态存储提供程序
保护会话状态
ASP.NET 配置文件层次结构和继承
保证 ASP.NET 配置的安全
ASP.NET 配置方案

其他资源

使用受保护的配置加密配置信息
常规配置设置 (ASP.NET)
ASP.NET 配置设置
配置 ASP.NET 应用程序
ASP.NET 配置 API

属性和元素

属性

子元素

父元素

备注

示例

元素信息

请参见

任务

参考

概念

其他资源