Freigeben über

LoginView.RoleGroups Eigenschaft

Definition

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

Ruft eine Auflistung von Rollengruppen ab, die Inhaltsvorlagen bestimmten Rollen zuordnen.

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

Eigenschaftswert

RoleGroupCollection

Ein RoleGroupCollection Objekt, das die definierten Rollengruppenvorlagen enthält.

Attribute
PersistenceModeAttribute ThemeableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der RoleGroups Auflistung veranschaulicht. Da die AnonymousTemplate Eigenschaften nicht LoggedInTemplate festgelegt sind, wird der Inhalt nur für Benutzer angezeigt, die zu Rollen mit einer definierten Inhaltsvorlage gehören.

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

Hinweise

Die RoleGroups Eigenschaft enthält die Inhaltsvorlagen, die verschiedenen Rollen auf der Website zugeordnet sind. Die Auflistung in der RoleGroups Eigenschaft wird in der Reihenfolge durchsucht, in der Vorlagen in der Quelle definiert sind. Die erste übereinstimmende Rollengruppenvorlage wird dem Benutzer angezeigt. Wenn ein Benutzer Mitglied mehrerer Rollen ist, wird die erste Rollengruppenvorlage verwendet, die mit einer der Rollen des Benutzers übereinstimmt. Wenn mehr als eine Vorlage einer einzelnen Rolle zugeordnet ist, wird nur die erste definierte Vorlage verwendet.

Wenn ein angemeldeter Benutzer nicht zu einer Rolle gehört, die in der Rollengruppensammlung enthalten ist, zeigt die Website die in der LoggedInTemplate Eigenschaft angegebene Inhaltsvorlage an. Anonyme Benutzer werden niemals eine Vorlage in der RoleGroups Sammlung angezeigt.

Sie müssen die Rollenverwaltung so konfigurieren, dass die RoleGroups Eigenschaft verwendet wird, um Vorlagen basierend auf der Rolle des Benutzers auf der Website zu definieren. Weitere Informationen finden Sie unter Grundlegendes zur Rollenverwaltung.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.

Gilt für:

Weitere Informationen