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 Eigenschaften und LoggedInTemplate nicht festgelegt sind, wird der Inhalt nur benutzern angezeigt, die rollen mit einer definierten Inhaltsvorlage angehö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 einer einzelnen Rolle mehrere Vorlagen zugeordnet sind, wird nur die erste definierte Vorlage verwendet.

Wenn ein angemeldeter Benutzer keiner Rolle angehört, die in der Rollengruppensammlung enthalten ist, zeigt die Website die in der LoggedInTemplate -Eigenschaft angegebene Inhaltsvorlage an. Anonymen Benutzern wird niemals eine Vorlage angezeigt, die in der RoleGroups Sammlung enthalten ist.

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