RoleManagerModule.GetRoles 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在 RoleManagerModule 准备好创建一个表示当前用户的 RolePrincipal 时引发的全局应用程序事件。
public:
event System::Web::Security::RoleManagerEventHandler ^ GetRoles;
public event System.Web.Security.RoleManagerEventHandler GetRoles;
member this.GetRoles : System.Web.Security.RoleManagerEventHandler
Public Custom Event GetRoles As RoleManagerEventHandler
事件类型
示例
以下示例演示 ASP.NET GetRoles 应用程序的 Global.asax 文件中包含的 事件。 事件 GetRoles 为在 Web.config 文件中启用了跟踪的应用程序添加跟踪通知。
public void RoleManager_OnGetRoles(object sender, RoleManagerEventArgs args)
{
args.Context.Trace.Write("Roles", "Applying Role Information");
}
Public Sub RoleManager_OnGetRoles(sender As Object, args As RoleManagerEventArgs)
args.Context.Trace.Write("Roles", "Applying Role Information")
End Sub
注解
在 GetRoles 创建 RolePrincipal 对象并将其分配给 User 的 属性之前RoleManagerModule引发事件CurrentHttpContext。 可以使用此事件来审核何时应用角色信息,或者将 创建的 RoleManagerModule 替换为RolePrincipal自己的代码。
可以通过在 事件中GetRoles将 的 RoleManagerEventArgs 属性设置为 RolesPopulated 来true
取消对角色信息RoleManagerModule的应用。
如果在事件处理程序中GetRoles将 设置为 RolesPopulatedtrue
,则User当前 HttpContext 的 属性不会由 RoleManagerModule设置为 RolePrincipal 对象。