RoleGroup クラス
メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。 LoginView コントロールのコンテンツ テンプレートを、Web サイトに対して定義されている 1 つ以上のロールに関連付けます。このクラスは継承できません。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
.NET Framework のセキュリティ
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説LoginView コントロールを使用すると、Web サイトのユーザーに表示されるコンテンツを含むコンテンツ テンプレートのセットを、Web サイト管理者が割り当てたロールに基づき定義できます。LoginView コントロールは、RoleGroup クラスを使用して、コンテンツ テンプレートをロールのセットに関連付けます。
テンプレートをロール グループに動的に割り当てるには、ContentTemplate プロパティに、ITemplate インターフェイスを実装するオブジェクトへの参照を設定します。
RoleGroup クラスを使用するには、ロール管理を構成する必要があります。詳細については、「ロール管理について」を参照してください。
使用例次のコード例では、カスタム テンプレートを ContentTemplate プロパティに割り当てています。
<%@ Page Language="VB"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> Private Class CustomTemplate Implements ITemplate Public Sub InstantiateIn(ByVal container As System.Web.UI.Control) _ Implements System.Web.UI.ITemplate.InstantiateIn Dim ln As New LoginName Dim ls As New LoginStatus Dim lc As New Literal lc.Text = "<br>" ln.FormatString = "Welcome, {0}. This line is from the template." container.Controls.Add(ln) container.Controls.Add(lc) container.Controls.Add(ls) End Sub End Class Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Dim rg As New RoleGroup rg.ContentTemplate = New CustomTemplate Dim RoleList(1) As String RoleList(0) = "users" rg.Roles = RoleList Dim rgc As RoleGroupCollection = LoginView1.RoleGroups rgc.Add(rg) End Sub </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:LoginView id="LoginView1" runat="server"> <AnonymousTemplate> You are not logged in.<br /> <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus> </AnonymousTemplate> <LoggedInTemplate> You are logged in as <asp:LoginName id="LoginName1" runat="server" />. This message is not from the template.<br /> <asp:LoginStatus id="Loginstatus2" runat="server"></asp:LoginStatus> </LoggedInTemplate> </asp:LoginView> </FORM> </BODY> </HTML>
<%@ Page Language="C#"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> private class CustomTemplate : ITemplate { public void InstantiateIn(System.Web.UI.Control container) { LoginName ln = new LoginName(); LoginStatus ls = new LoginStatus(); Literal lc = new Literal(); lc.Text = "<br>"; ln.FormatString = "Welcome, {0}. This line is from the template."; container.Controls.Add(ln); container.Controls.Add(lc); container.Controls.Add(ls); } } void Page_Load(Object sender, EventArgs e) { RoleGroup rg = new RoleGroup(); rg.ContentTemplate = new CustomTemplate(); String[] RoleList = {"users"}; rg.Roles = RoleList; RoleGroupCollection rgc = LoginView1.RoleGroups; rgc.Add(rg); } </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:LoginView id="LoginView1" runat="server"> <AnonymousTemplate> You are not logged in.<br /> <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus> </AnonymousTemplate> <LoggedInTemplate> You are logged in as <asp:LoginName id="LoginName1" runat="server" />. This message is not from the template.<br /> <asp:LoginStatus id="Loginstatus2" runat="server"></asp:LoginStatus> </LoggedInTemplate> </asp:LoginView> </FORM> </BODY> </HTML>
.NET Framework のセキュリティ継承階層
System.Object
System.Web.UI.WebControls.RoleGroup
System.Web.UI.WebControls.RoleGroup
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照RoleGroup コンストラクタ
メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。 RoleGroup クラスの新しいインスタンスを初期化します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照RoleGroup プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | ContentTemplate | このロール グループに関連付けられているコンテンツ テンプレートを取得または設定します。 |
| | Roles | このロール グループに関連付けられているロールを取得または設定します。 |
参照RoleGroup メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | ContainsUser | 指定したユーザーがロール グループのロールを持つメンバかどうか示します。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | オーバーライドされます。 このロール グループに関連付けられているロールのコンマ区切りリストを返します。 |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照RoleGroup メンバ
LoginView コントロールのコンテンツ テンプレートを、Web サイトに対して定義されている 1 つ以上のロールに関連付けます。このクラスは継承できません。
RoleGroup データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| | ContentTemplate | このロール グループに関連付けられているコンテンツ テンプレートを取得または設定します。 |
| | Roles | このロール グループに関連付けられているロールを取得または設定します。 |
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
| | ContainsUser | 指定したユーザーがロール グループのロールを持つメンバかどうか示します。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | オーバーライドされます。 このロール グループに関連付けられているロールのコンマ区切りリストを返します。 |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- RoleGroupのページへのリンク
