LoginView.RoleGroups Propriedade

Definição

Obtém uma coleção de grupos de funções que associam modelos de conteúdo a funções específicas.Gets a collection of role groups that associate content templates with particular roles.

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

Valor da propriedade

RoleGroupCollection

Um objeto RoleGroupCollection que contém os modelos de grupos de funções definidos.A RoleGroupCollection object that contains the defined role-group templates.

Atributos

Exemplos

O exemplo de código a seguir demonstra o uso da RoleGroups coleção.The following code example demonstrates using the RoleGroups collection. Como as AnonymousTemplate LoggedInTemplate Propriedades e não são definidas, o conteúdo é exibido somente para os usuários que pertencem a funções com um modelo de conteúdo definido.Because the AnonymousTemplate and LoggedInTemplate properties are not set, the content is displayed only to users who belong to roles with a defined content template.

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

Comentários

A RoleGroups propriedade contém os modelos de conteúdo associados a várias funções no site.The RoleGroups property contains the content templates associated with various roles on the Web site. A coleção na RoleGroups propriedade é pesquisada na ordem em que os modelos são definidos na origem.The collection in the RoleGroups property is searched in the order in which templates are defined in the source. O primeiro modelo de grupo de funções correspondente é exibido para o usuário.The first matching role-group template is displayed to the user. Se um usuário for membro de mais de uma função, o primeiro modelo de grupo de função que corresponde a qualquer uma das funções do usuário será usado.If a user is a member of more than one role, the first role-group template that matches any of the user's roles is used. Se mais de um modelo estiver associado a uma única função, somente o primeiro modelo definido será usado.If more than one template is associated with a single role, only the first defined template will be used.

Se um usuário conectado não pertencer a nenhuma função contida na coleção de grupos de funções, o site exibirá o modelo de conteúdo especificado na LoggedInTemplate propriedade.If a logged-in user does not belong to any role contained in the role-group collection, the site displays the content template specified in the LoggedInTemplate property. Os usuários anônimos nunca são mostrados qualquer modelo contido na RoleGroups coleção.Anonymous users are never shown any template contained in the RoleGroups collection.

Você deve configurar o gerenciamento de função para usar a RoleGroups propriedade para definir modelos com base na função do usuário no site.You must configure role management to use the RoleGroups property to define templates based on the user's role on the Web site. Para obter mais informações, consulte Understanding Role Management.For more information, see Understanding Role Management.

Esta propriedade não pode ser definida por temas ou temas de folha de estilo.This property cannot be set by themes or style sheet themes. Para obter mais informações, consulte ThemeableAttribute e temas e capas do ASP.net.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Aplica-se a

Confira também