RoleManagerModule.GetRoles 事件

定义

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 

事件类型

示例

以下示例显示了 GetRoles 包含在 ASP.NET 应用程序的 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 对象并将其分配给 UserHttpContextCurrent 属性之前RoleManagerModule引发事件。 可以使用此事件来审核何时应用角色信息,或者将 创建的 RoleManagerModule 替换为RolePrincipal自己的代码。

通过在 事件中将 的 RoleManagerEventArgs 属性设置为 trueRolesPopulated ,可以取消应用角色信息RoleManagerModuleGetRoles

如果在事件处理程序中GetRoles将 设置为 RolesPopulatedtrue ,则 User 当前 HttpContext 的 属性不会由 RoleManagerModule设置为 RolePrincipal 对象。

适用于

另请参阅