LoginView.RoleGroups プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

LoginView.RoleGroups プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

コンテンツテンプレートを特定のロールに関連付けるロールグループのコレクションを取得します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overridable ReadOnly
 Property RoleGroups As RoleGroupCollection

Visual Basic (使用法)

Dim instance As LoginView
Dim value As RoleGroupCollection

value = instance.RoleGroups

[ThemeableAttribute(false)] 
public virtual RoleGroupCollection RoleGroups { get;
 }

C++

[ThemeableAttribute(false)] 
public:
virtual property RoleGroupCollection^ RoleGroups {
    RoleGroupCollection^ get ();
}

/** @property */
public RoleGroupCollection get_RoleGroups ()

JScript

public function get RoleGroups
 () : RoleGroupCollection

プロパティ値
定義済みロールグループテンプレートを格納している RoleGroupCollection オブジェクト。

解説

RoleGroups プロパティには、Web サイトの各種ロールに関連付けられているコンテンツテンプレートが格納されています。RoleGroups プロパティのコレクションは、テンプレートがソースに定義されている順序で検索されます。最初に一致するロールグループテンプレートがユーザーに表示されます。ユーザーが複数のロールのメンバの場合は、ユーザーのいずれかのロールに最初に一致するロールグループテンプレートが使用されます。1 つのロールに複数のテンプレートが関連付けられている場合は、最初に定義されているテンプレートだけが使用されます。

ログインしているユーザーがロールグループコレクションのロールに属さない場合は、LoggedInTemplate プロパティで指定されたコンテンツテンプレートがサイトに表示されます。匿名ユーザーには、RoleGroups コレクションのテンプレートは表示されません。

RoleGroups プロパティを使用して、Web サイトのユーザーのロールに基づいてテンプレートを定義するには、ロール管理を設定する必要があります。詳細については、「ロール管理について」を参照してください。

このプロパティを、テーマまたはスタイルシートテーマを使用して設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要の各トピックを参照してください。

Topic	Location
方法 : 匿名ユーザーおよびログインユーザーに異なる情報を表示する	ASP .NET Web アプリケーションの作成
方法 : 匿名ユーザーとログインユーザーに異なる情報を表示する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

RoleGroups コレクションを使用するコード例を次に示します。AnonymousTemplate プロパティと LoggedInTemplate プロパティが設定されていないため、コンテンツは、定義済みコンテンツテンプレートのロールに属するユーザーだけに表示されます。

Visual Basic

<%@ 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">
</SCRIPT>

<HTML>
    <BODY>
        <FORM runat="server">
            <asp:LoginView id="LoginView1" runat="server">
                <RoleGroups>
                    <asp:RoleGroup Roles="author">
                        <ContentTemplate>
                            <ul>
                                <li>Add a new article.</li>
                                <li>Review editorial changes.</li>
                                <li>View article requests.</li>
                            </ul>
                        </ContentTemplate>
                    </asp:RoleGroup>
                    <asp:RoleGroup Roles="editor">
                        <ContentTemplate>
                            <ul>
                                <li>Review articles.</li>
                                <li>Submit edited article.</li>
                            </ul>
                        </ContentTemplate>
                    </asp:RoleGroup>
                    <asp:RoleGroup Roles="publisher">
                        <ContentTemplate>
                            <ul>
                                <li>Make article request.</li>
                                <li>Publish reviewed article.</li>
                            </ul>
                        </ContentTemplate>
                    </asp:RoleGroup>
                </RoleGroups>
            </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">
</SCRIPT>

<HTML>
    <BODY>
        <FORM runat="server">
            <asp:LoginView id="LoginView1" runat="server">
                <RoleGroups>
                    <asp:RoleGroup Roles="author">
                        <ContentTemplate>
                            <ul>
                                <li>Add a new article.</li>
                                <li>Review editorial changes.</li>
                                <li>View article requests.</li>
                            </ul>
                        </ContentTemplate>
                    </asp:RoleGroup>
                    <asp:RoleGroup Roles="editor">
                        <ContentTemplate>
                            <ul>
                                <li>Review articles.</li>
                                <li>Submit edited article.</li>
                            </ul>
                        </ContentTemplate>
                    </asp:RoleGroup>
                    <asp:RoleGroup Roles="publisher">
                        <ContentTemplate>
                            <ul>
                                <li>Make article request.</li>
                                <li>Publish reviewed article.</li>
                            </ul>
                        </ContentTemplate>
                    </asp:RoleGroup>
                </RoleGroups>
            </asp:LoginView>
        </FORM>
    </BODY>
</HTML>