sessionState 的 providers 元素(ASP.NET 设置架构)

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

包含自定义会话状态存储提供程序的集合。

此元素是 .NET Framework 2.0 版中的新元素。

<providers>
   <add 
      
      
      
      
   />
   <remove />
   <clear/>
</providers>

特性和元素

以下几节描述了特性、子元素和父元素。

特性

无。

子元素

元素

说明

Add

可选元素。

向会话状态存储提供程序的集合添加提供程序。

clear

可选元素。

移除所有对继承的会话状态存储提供程序的引用,仅允许那些由当前 add 元素添加的会话状态存储提供程序。

Remove

可选元素。

从集合中移除对继承的会话状态存储提供程序的引用。

父元素

元素

说明

configuration

指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素,并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。

sessionState

为当前应用程序配置会话状态设置。

备注

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

有关访问和修改应用程序代码中 sessionState 元素的配置值的信息,请参见 ProviderSettingsCollectionProviders

默认配置

下面的默认 providers 元素不是在 Machine.config 文件或根 Web.config 文件中显式配置的, 而是由应用程序返回的默认配置。

<sessionState
   <!-- Attribute settings. -->
>
   <providers>
      <clear />
   </providers>
</sessionState>

示例

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

元素信息

配置节处理程序

SessionStateSection

配置成员

ProviderSettingsCollection

Providers

可配置的位置

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

请参见

任务

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

参考

sessionState 元素(ASP.NET 设置架构)

sessionState 的 providers 的 add 元素(ASP.NET 设置架构)

sessionState 的 providers 的 clear 元素(ASP.NET 设置架构)

sessionState 的 providers 的 remove 元素(ASP.NET 设置架构)

system.web 元素(ASP.NET 设置架构)

sessionState 的 providers 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

System.Configuration

System.Web.Configuration

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

概念

Implementing a Session-State Store Provider

Securing Session State

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

其他资源

Protected Configuration

常规配置设置 (ASP.NET)

ASP.NET 配置设置

Configuring ASP.NET Applications

ASP.NET Configuration API