LoginView.RoleGroups Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u een verzameling rollengroepen op die inhoudssjablonen aan bepaalde rollen koppelen.

public:
 virtual property System::Web::UI::WebControls::RoleGroupCollection ^ RoleGroups { System::Web::UI::WebControls::RoleGroupCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.WebControls.RoleGroupCollection RoleGroups { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.Themeable(false)>]
member this.RoleGroups : System.Web.UI.WebControls.RoleGroupCollection
Public Overridable ReadOnly Property RoleGroups As RoleGroupCollection

Waarde van eigenschap

RoleGroupCollection

Een RoleGroupCollection object dat de gedefinieerde sjablonen voor rollengroepen bevat.

Kenmerken
PersistenceModeAttribute ThemeableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de RoleGroups verzameling gebruikt. Omdat de AnonymousTemplate en LoggedInTemplate eigenschappen niet zijn ingesteld, wordt de inhoud alleen weergegeven voor gebruikers die deel uitmaken van rollen met een gedefinieerde inhoudssjabloon.

<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" 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="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 xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" 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>

Opmerkingen

De RoleGroups eigenschap bevat de inhoudssjablonen die zijn gekoppeld aan verschillende rollen op de website. De verzameling in de RoleGroups eigenschap wordt doorzocht in de volgorde waarin sjablonen in de bron worden gedefinieerd. De eerste overeenkomende sjabloon voor rollengroepen wordt aan de gebruiker weergegeven. Als een gebruiker lid is van meer dan één rol, wordt de eerste rolgroepsjabloon gebruikt die overeenkomt met een van de rollen van de gebruiker. Als meer dan één sjabloon aan één rol is gekoppeld, wordt alleen de eerste gedefinieerde sjabloon gebruikt.

Als een aangemelde gebruiker geen deel uitmaakt van een rol in de verzameling rollengroepen, wordt op de site de inhoudssjabloon weergegeven die is opgegeven in de LoggedInTemplate eigenschap. Anonieme gebruikers worden nooit een sjabloon in de RoleGroups verzameling weergegeven.

U moet rolbeheer configureren om de RoleGroups eigenschap te gebruiken om sjablonen te definiëren op basis van de rol van de gebruiker op de website. Zie Rollenbeheer begrijpen voor meer informatie.

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Van toepassing op

Zie ook