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され、 の プロパティに割り当てられる前RoleManagerModuleUser発生しますCurrentHttpContext。 このイベントを使用すると、ロール情報が適用されるタイミングを監査したり、 による RoleManagerModule の作成を独自のRolePrincipalコードに置き換えたりできます。

イベントで の プロパティを にtrue設定することで、 RolesPopulated によってRoleManagerModuleロール情報のRoleManagerEventArgs適用をGetRoles取り消すことができます。

イベント ハンドラーで GetRoles を にtrue設定RolesPopulatedした場合、User現在HttpContextの の プロパティは によって RoleManagerModuleオブジェクトにRolePrincipal設定されません。

適用対象

こちらもご覧ください