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

更新:2007 年 11 月

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

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

configuration 元素(常规设置架构)
  system.web 元素(ASP.NET 设置架构)
    sessionState 元素(ASP.NET 设置架构)
      sessionState 的 providers 元素(ASP.NET 设置架构)
        sessionState 的 providers 的 remove 元素(ASP.NET 设置架构)

<remove 
   name="provider name"
/>

属性和元素

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

属性

属性

说明

name

必选的 String 属性。

指定要从集合中移除的会话状态存储提供程序的实例的名称。

子元素

无。

父元素

元素

说明

configuration

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

system.web

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

sessionState

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

providers

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

备注

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

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

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

示例

下面的代码示例演示如何配置 ASP.NET 应用程序的 Web.config 文件,以使用自定义会话状态存储提供程序。该示例在添加自定义会话状态存储提供程序之前,使用 remove 元素移除名为 OdbcSessionProvider 的现有会话状态存储提供程序对象。

有关实现会话状态存储提供程序的信息(包括一个示例提供程序),请参见实现会话状态存储提供程序

<configuration>
  <connectionStrings>
    <add name="OdbcSessionServices" connectionString="DSN=SessionState;" />
  </connectionStrings>

  <system.web>
    <sessionState 
      cookieless="true"
      regenerateExpiredSessionId="true" 
      mode="Custom"
      customProvider="OdbcSessionProvider">
      <providers>
        <remove name="OdbcSessionProvider" />
        <add name="OdbcSessionProvider"
          type="Samples.AspNet.Session.OdbcSessionStateStore"
          connectionStringName="OdbcSessionServices" 
          writeExceptionsToEventLog="false" />
      </providers>
    </sessionState>
  </system.web>
</configuration>

元素信息

配置节处理程序

SessionStateSection

配置成员

Remove

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

请参见

任务

如何:使用位置设置配置特定目录

如何:锁定 ASP.NET 配置设置

概念

实现会话状态存储提供程序

保护会话状态

ASP.NET 配置文件层次结构和继承

保证 ASP.NET 配置的安全

ASP.NET 配置方案

参考

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

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

sessionState 的 providers 的 clear 元素(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 配置 API