Sdílet prostřednictvím

LoginView.RoleGroups Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá kolekci skupin rolí, které přidružují šablony obsahu k určitým rolím.

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

Hodnota vlastnosti

RoleGroupCollection

Objekt RoleGroupCollection , který obsahuje definované šablony skupin rolí.

Atributy
PersistenceModeAttribute ThemeableAttribute

Příklady

Následující příklad kódu ukazuje použití RoleGroups kolekce. Vzhledem k tomu, že vlastnosti AnonymousTemplate nejsou LoggedInTemplate nastaveny, obsah se zobrazí jenom uživatelům, kteří patří do rolí s definovanou šablonou obsahu.

<%@ 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>

Poznámky

Vlastnost RoleGroups obsahuje šablony obsahu přidružené k různým rolím na webu. Kolekce ve RoleGroups vlastnosti je prohledána v pořadí, ve kterém jsou šablony definovány ve zdroji. Uživateli se zobrazí první odpovídající šablona skupiny rolí. Pokud je uživatel členem více než jedné role, použije se první šablona skupiny rolí, která odpovídá některé z rolí uživatele. Pokud je k jedné roli přidruženo více než jedna šablona, použije se pouze první definovaná šablona.

Pokud přihlášený uživatel nepatří do žádné role obsažené v kolekci skupin rolí, web zobrazí šablonu obsahu zadanou LoggedInTemplate ve vlastnosti. Anonymní uživatelé se nikdy nezobrazují žádná šablona obsažená v kolekci RoleGroups .

Správu rolí musíte nakonfigurovat tak, aby používala RoleGroups vlastnost k definování šablon na základě role uživatele na webu. Další informace najdete v tématu Principy správy rolí.

Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Platí pro

Viz také