roleManager 的 providers 的 clear 元素（ASP.NET 设置架构）
更新：2007 年 11 月
移除所有对继承的角色提供程序的引用，仅允许那些由当前 add 元素添加的角色提供程序。
此元素是 .NET Framework 2.0 版中的新元素。
configuration 元素（常规设置架构）
system.web 元素（ASP.NET 设置架构）
roleManager 元素（ASP.NET 设置架构）
roleManager 的 providers 元素（ASP.NET 设置架构）
roleManager 的 providers 的 clear 元素（ASP.NET 设置架构）
<clear/>
属性和元素
下面几部分描述了属性、子元素和父元素。
属性
无。
子元素
无。
父元素
元素 |
说明 |
|---|---|
configuration |
指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
为 ASP.NET 配置节指定根元素。 |
roleManager |
为角色管理配置应用程序。 |
providers |
为角色管理定义一个角色提供程序的集合。 |
备注
clear 元素移除所有对存储在 providers 元素中的继承角色管理提供程序的引用，仅允许那些由后继 add 元素添加的角色管理提供程序。
providers 元素为角色管理定义一个角色提供程序集合。
有关访问和修改应用程序代码中 roleManager 元素的配置值的信息，请参见 RoleManagerSection。
示例
下面的代码示例演示如何配置一个 ASP.NET 应用程序，以使用 SqlRoleProvider 提供程序来存储和检索角色信息。<clear> 元素在添加 SqlRoleProvider 之前清除 RoleProviderCollection 集合。
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<clear />
<add
name="SqlProvider"
type="System.Web.Security.SqlRoleProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication" />
</providers>
</roleManager>
</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 |
请参见
任务
概念
参考
roleManager 的 providers 元素（ASP.NET 设置架构）
roleManager 的 providers 的 add 元素（ASP.NET 设置架构）
roleManager 的 providers 的 remove 元素（ASP.NET 设置架构）