Roles 类

定义

public ref class Roles abstract sealed

public static class Roles

type Roles = class

Public Class Roles

继承

Object

Roles

示例

以下示例显示了配置为使用 ASP.NET 成员身份和 ASP.NET 角色的应用程序 Web.config 文件，以及用于 SqlRoleProvider 在 SQL Server 数据库中存储成员身份和角色信息。 用户通过表单身份验证进行身份验证，并且仅允许管理员角色中的用户访问应用程序。

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Initial Catalog=aspnetdb;Integrated Security=SSPI;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>

    <authorization>
      <deny users="?" />
      <allow roles="Administrators" />
      <deny users="*" />
    </authorization>

    <membership defaultProvider="AspNetSqlProvider" userIsOnlineTimeWindow="15">
    </membership>

    <roleManager defaultProvider="SqlProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="true"
      cookieSlidingExpiration="true"
      cookieProtection="All" >

      <providers>
        <clear />
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices"
          applicationName="SampleApplication" />
        </providers>

    </roleManager>
  </system.web>
</configuration>

以下代码示例以编程方式检查登录用户是否处于管理员角色，然后允许用户查看其他用户的角色。

注解

ASP.NET 角色管理使你能够基于用户组（称为角色）管理应用程序的授权。 通过将用户分配到角色，可以基于角色而不是基于用户名指定授权来控制对 Web 应用程序的不同部件或功能的访问权限。 例如，员工应用程序可能具有经理、员工、董事等角色，其中为每个角色指定了不同的特权。

用户可以属于多个角色。 例如，如果你的网站是一个讨论论坛，则某些用户可能同时担任“成员”和“审查者”角色。 可以定义每个角色以在站点上具有不同的权限，并且两个角色中的用户将拥有这两组权限。

若要为 ASP.NET 应用程序启用角色管理，请使用应用程序 Web.config 文件中节的 roleManager 元素 system.web ，如以下示例所示。

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Initial Catalog=aspnetdb;Integrated Security=SSPI;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>

  <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>

可以在 Web 应用程序的配置文件中指定授权规则，也可以在代码中以编程方式指定授权规则。 例如，Web.config 文件中的以下 授权 部分要求用户登录（拒绝匿名用户），然后仅允许管理员角色中的用户具有访问权限。

<authorization>
  <deny users="?" />
  <allow roles="Administrators" />
  <deny users="*" />
</authorization>

如果使用 authorization 应用程序的 Web.config 文件中的部分来指定基于角色的授权，则应用程序的用户必须提供经过身份验证的用户标识。 可以使用 Windows 或窗体身份验证对用户进行身份验证。 匿名用户无法分配给角色。 角色可以独立于或与 ASP.NET Membership 类一起使用。

若要以编程方式验证角色成员身份，可以将类或Page.User属性与方法一Roles起使用IsUserInRole，也可以将Page.User属性与该方法一起使用IPrincipal.IsInRole。 有关以编程方式检查角色成员身份的示例代码，请参阅本主题中的“示例”部分。

该 Roles 类还允许你创建和删除角色，以及将用户添加到角色或从角色中删除用户。

可以在多个数据源中存储角色信息。

• 可以使用 WindowsTokenRoleProvider 该类根据 Windows 组中的成员身份检索角色信息。

• 可以使用该类将角色信息存储在 SQL Server 数据库中 SqlRoleProvider 。

• 如果你有现有角色信息，或者想要在 Windows、授权存储或 SQL Server 以外的数据源中存储角色信息并从中检索角色信息，则可以通过创建继承抽象类的 RoleProvider 类来实现自定义角色提供程序。 有关详细信息，请参阅 “实现角色提供程序”。

如果用户的浏览器接受 Cookie，则可以将该用户的角色信息存储在用户计算机上的 Cookie 中。 在每个页面请求中，ASP.NET 从 Cookie 中读取该用户的角色信息。 这可以通过减少与数据源检索角色信息所需的通信量来提高应用程序性能。 如果用户的角色信息太长而无法存储在 Cookie 中，ASP.NET 只存储 Cookie 中最近使用的角色信息，然后根据需要在数据源中查找其他角色信息。 如果用户的浏览器不支持 Cookie 或 Cookie，则角色信息不会缓存在 Cookie 中。

可以通过在配置 ASP.NET 角色时指定 CookieProtectionValue 属性来提高 Cookie 中缓存的角色名称的可靠性。 默认值 CookieProtectionValue 是 All加密 Cookie 中的角色名称，并验证 Cookie 内容是否已更改。

另请参阅

• 了解 ASP.NET 角色管理