roleManager 的 providers 元素（ASP.NET 设置架构）
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
为角色管理定义一个角色提供程序的集合。
<providers>
<add />
<clear/>
<remove />
</providers>
特性和元素
下面几部分描述了本节涉及的特性、子元素和父元素。
特性
无。
子元素
元素 |
说明 |
|---|---|
add |
可选元素。 向角色管理提供程序集合添加一个角色提供程序实例。 |
clear |
可选元素。 移除所有对继承的角色管理提供程序的引用，仅允许那些由当前 add 元素添加的引用。 |
remove |
可选元素。 从角色管理提供程序集合中移除对继承的提供程序的引用。 |
父元素
元素 |
说明 |
|---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
为 ASP.NET 配置节指定根元素。 |
roleManager |
为角色管理配置应用程序。 |
备注
providers 元素为角色管理定义一个角色提供程序集合。
有关访问和修改应用程序代码中 roleManager 元素的配置值的信息，请参见 RoleManagerSection 类和以下角色提供程序：WindowsTokenRoleProvider 和 SqlRoleProvider。
默认配置
下面的默认 element 元素是在计算机配置文件中配置的。
<roleManager>
<providers>
<add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
</roleManager>
示例
下面的示例演示一个 ASP.NET 应用程序，此应用程序配置为使用 SqlRoleProvider 类来存储和检索角色信息。
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<add
name="SqlProvider"
type="System.Web.Security.SqlRoleProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication" />
</providers>
</roleManager>
</system.web>
</configuration>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
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 |
请参见
任务
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
参考
roleManager 的 providers 的 add 元素（ASP.NET 设置架构）
roleManager 的 providers 的 clear 元素（ASP.NET 设置架构）
roleManager 的 providers 的 remove 元素（ASP.NET 设置架构）
概念
Understanding ASP.NET Role Management