roleManager 的 providers 元素（ASP.NET 设置架构）

.NET Framework 常规参考

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

configuration 元素（常规设置架构）
  system.web 元素（ASP.NET 设置架构）
    roleManager 元素（ASP.NET 设置架构）
      roleManager 的 providers 元素（ASP.NET 设置架构）

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

属性和元素

下面几部分描述了本节涉及的属性、子元素和父元素。

属性

无。

子元素

元素	说明
add	可选的元素。向角色管理提供程序集合添加一个角色提供程序实例。
clear	可选的元素。移除所有对继承的角色管理提供程序的引用，仅允许那些由当前 add 元素添加的引用。
remove	可选的元素。从角色管理提供程序集合中移除对继承的提供程序的引用。

元素

说明

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>

元素信息

配置节处理程序	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

请参见

属性

子元素

父元素

任务

参考

概念

其他资源