RoleServiceManager 类

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

配置角色服务的自定义实现的位置。

public ref class RoleServiceManager

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.EmptyStringExpandableObjectConverter))]
public class RoleServiceManager

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.EmptyStringExpandableObjectConverter))>]
type RoleServiceManager = class

Public Class RoleServiceManager

已启用 AJAX 的应用程序使用角色 Web 服务，通过异步 Web 服务调用检索当前经过身份验证的用户的角色信息。可以使用 RoleServiceManager 来提供角色 Web 服务的替代实现的路径，而不是使用内置 Web 服务。

若要在应用程序中使用角色服务，必须在配置文件中启用它并在页面中声明它。如果使用内置角色 Web 服务，则必须启用它，但不必在页面中显式声明角色服务管理器。

若要创建自定义角色服务，必须实现具有两种方法的 Web 服务： GetRolesForCurrentUser 和 IsCurrentUserInRole。这些方法的签名必须与内置角色 Web 服务的相应方法相同。

以下示例演示必须在自定义角色 Web 服务类中实现的基本类结构。

若要使用自定义角色 Web 服务，可以通过将元素置于 RoleService 控件中，以声明方式在标记中添加服务 ScriptManager ，如以下示例所示。

<asp:ScriptManager ID="SM1" runat="server">  
  <RoleService Path="MyRoleService.asmx" LoadRoles="true" />  
</asp:ScriptManager>

还可以以编程方式将 Path 属性设置为使用自定义角色 Web 服务。

初始化 RoleServiceManager 类的新实例。

LoadRoles	获取或设置一个值，该值指示是否必须检索当前已登录用户的角色列表。
Path	获取或设置角色服务的路径。