Freigeben über

LoginView.RoleGroups Eigenschaft

  • Referenz

Definition

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

Ruft eine Auflistung von Rollengruppen ab, die Inhaltsvorlagen besonderen 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 LoggedInTemplate Eigenschaften nicht festgelegt sind, wird der Inhalt nur benutzern 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 einer der Rollen des Benutzers entspricht. Wenn mehrere Vorlagen einer einzelnen Rolle zugeordnet sind, 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 in der RoleGroups Sammlung enthaltene Vorlage angezeigt.

Sie müssen die Rollenverwaltung konfigurieren, um mithilfe der RoleGroups Eigenschaft 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

Siehe auch