Udostępnij za pośrednictwem


LoginView.RoleGroups Właściwość

Definicja

Pobiera kolekcję grup ról, które kojarzą szablony zawartości z określonymi rolami.

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

Wartość właściwości

RoleGroupCollection Obiekt zawierający zdefiniowane szablony grup ról.

Atrybuty

Przykłady

Poniższy przykład kodu przedstawia użycie kolekcji RoleGroups . AnonymousTemplate Ponieważ właściwości i LoggedInTemplate nie są ustawione, zawartość jest wyświetlana tylko dla użytkowników, którzy należą do ról ze zdefiniowanym szablonem zawartości.

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

Uwagi

Właściwość RoleGroups zawiera szablony zawartości skojarzone z różnymi rolami w witrynie sieci Web. Kolekcja we RoleGroups właściwości jest przeszukiwana w kolejności, w której szablony są zdefiniowane w źródle. Pierwszy pasujący szablon grupy ról jest wyświetlany użytkownikowi. Jeśli użytkownik jest członkiem więcej niż jednej roli, zostanie użyty pierwszy szablon grupy ról zgodny z dowolną z ról użytkownika. Jeśli więcej niż jeden szablon jest skojarzony z jedną rolą, zostanie użyty tylko pierwszy zdefiniowany szablon.

Jeśli zalogowany użytkownik nie należy do żadnej roli zawartej w zbiorze grup ról, witryna wyświetla szablon zawartości określony we LoggedInTemplate właściwości . Użytkownicy anonimowi nigdy nie są wyświetlani żadnych szablonów zawartych w kolekcji RoleGroups .

Aby używać właściwości do definiowania szablonów na podstawie roli użytkownika w witrynie sieci Web, należy skonfigurować zarządzanie rolami RoleGroups . Aby uzyskać więcej informacji, zobacz Omówienie zarządzania rolami.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skórki.

Dotyczy

Zobacz też