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

更新:2007 年 11 月

从角色管理提供程序集合中移除对继承的提供程序的引用。

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

<remove 
   name=" provider name" 
/>

属性和元素

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

属性

属性

说明

name

必选的 String 属性。

要从集合中移除的角色提供程序实例的名称。此属性必须与向集合添加角色提供程序的 add 元素的 name 属性相同。

子元素

无。

父元素

元素

说明

configuration

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

system.web

为 ASP.NET 配置节指定根元素。

roleManager

为角色管理配置应用程序。

providers

为角色管理定义一个角色提供程序的集合。

备注

remove 元素从存储在 providers 元素中的角色管理提供程序集合中移除对继承的提供程序的引用。

providers 元素为角色管理定义一个角色提供程序集合。

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

示例

下面的示例演示一个 ASP.NET 应用程序,此应用程序配置为使用 SqlRoleProvider 来存储和检索角色信息。在添加新的 SqlRoleProvider 实例之前,<remove> 元素先移除默认的 SQL Server 角色提供程序实例。

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
        <remove name="AspNetSqlProvider" />
          <add
            name="SqlProvider"
            type="System.Web.Security.SqlRoleProvider"
            connectionStringName="SqlServices" 
            applicationName="SampleApplication" />
            
        </providers>
      </roleManager>
  </system.web>
</configuration>

元素信息

配置节处理程序

RoleManagerSection

配置成员

Providers

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

要求

IIS 5.0、IIS 5.1 或 IIS 6.0

.NET Framework 2.0

Visual Studio 2003 或 Visual Studio 2005

请参见

任务

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

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

概念

了解角色管理

保证 ASP.NET 配置的安全

ASP.NET 配置方案

参考

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

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

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

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

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

configuration 元素(常规设置架构)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

ASP.NET 参考

管理 ASP.NET 网站

ASP.NET 配置 API