RoleManagerSection 类
定义配置设置，这些设置用于支持 Web 应用程序的角色管理基础结构。
语法
class RoleManagerSection : ConfigurationSectionWithCollection
方法
下表列出了 RoleManagerSection 类公开的方法。
| 名称 | 说明 |
|---|---|
| 添加 | （继承自 ConfigurationSectionWithCollection。） |
| 清除 | （从 ConfigurationSectionWithCollection 继承。） |
| Get | （从 ConfigurationSectionWithCollection 继承。） |
| GetAllowDefinition | （继承自 ConfigurationSection。） |
| GetAllowLocation | （从 ConfigurationSection 继承。） |
| 删除 | （从 ConfigurationSectionWithCollection 继承。） |
| RevertToParent | （从 ConfigurationSection 继承。） |
| SetAllowDefinition | （从 ConfigurationSection 继承。） |
| SetAllowLocation | （从 ConfigurationSection 继承。） |
属性
下表列出了 RoleManagerSection 类公开的属性。
| 名称 | 描述 |
|---|---|
CacheRolesInCookie |
一个读/写 boolean 值。 如果当前用户的角色已缓存在某个 Cookie 中，则为 true；否则为 false。 默认为 false。 |
CookieName |
一个读/写 string 值，指定用于缓存角色名称的 Cookie 的名称。 默认值为“.ASPXROLES”。 |
CookiePath |
一个读/写 string 值，指定用于缓存角色名称的 Cookie 的虚拟路径。 默认值为“/”。 |
CookieProtection |
指定 Cookie 保护方案的读/写 sint32 枚举。 后文的“备注”部分列出了可能的值。 |
CookieRequireSSL |
一个读/写 boolean 值。 如果用于缓存角色名称的 Cookie 需要安全套接字层 (SSL) 连接才能返回到服务器，则为 true；否则为 false。 默认为 false。 |
CookieSlidingExpiration |
一个读/写 boolean 值。 如果用于缓存角色名称的 Cookie 定期重置，则为 true；否则为 false。 默认为 true。 |
CookieTimeout |
一个读/写 datetime 值，指定用于缓存角色名称的 Cookie 在过期之前保留的时长（以分钟为单位）。 默认为 30 分钟。 |
CreatePersistentCookie |
一个读/写 boolean 值。 如果角色名称在不同的浏览器会话中保持 Cookie 持久性，则为 true；否则为 false。 默认值为 false。CreatePersistentCookie 属性指示用于缓存角色名称的 Cookie 应该是持久 Cookie（表示该 Cookie 可以在不同的浏览器会话中使用）还是基于会话的 Cookie（表示在关闭浏览器时，该 Cookie 会丢失）。 默认值为 false，表示使用基于会话的 Cookie 来缓存角色名称。 |
DefaultProvider |
一个读/写 string 值，指定用于管理角色的默认提供程序的名称。 默认值为“AspNetSqlRoleProvider”。 此属性必须与 Providers 属性中指定的命名值匹配。 空字符串 ("") 不是有效值。 |
Domain |
一个读/写 string 值，指定与用于缓存角色名称的 Cookie 关联的域的名称。 默认值为空字符串("")。 如果未指定值，Domain 属性将返回 null。 |
Enabled |
一个读/写 boolean 值。 如果启用了 ASP.NET 角色管理功能（即可以在运行时访问），则为 true；否则为 false。 默认为 false。 |
Location |
（继承自 ConfigurationSection。）一个键属性。 |
MaxCachedResults |
一个读/写 sint32 值，指定 ASP.NET 在角色 Cookie 中缓存的最大角色数。 默认值为 25。 |
Path |
（继承自 ConfigurationSection。）一个键属性。 |
Providers |
一个 ProvidersSettings 值，指定角色管理提供程序。 注意：角色管理提供程序是提供对网站角色类型的访问的组件。 |
SectionInformation |
（从 ConfigurationSection 继承。） |
子类
此类不包含子类。
注解
下表列出了 CookieProtection 属性的可能值。 默认值为 3 (All)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 0 | None |
指定 Cookie 信息不受保护。 Cookie 中的信息以明文形式存储，并且在信息发送回服务器时不会进行验证。 |
| 1 | Validation |
确保 Cookie 中的信息在发送回服务器之前不会更改。 |
| 2 | Encryption |
加密 Cookie 中的信息。 |
| 3 | All |
指定使用 Validation 和 Encryption 值来保护 Cookie 中的信息。 |
继承层次结构
ConfigurationSectionWithCollection
RoleManagerSection
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 文件 | WebAdministration.mof |
另请参阅
ConfigurationSectionWithCollection 类
NameTypeElement 类
ProvidersSettings 类
CIM_DATETIME