LoginView.RoleGroups Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém uma coleção de grupos de funções que associam modelos de conteúdo a funções específicas.
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.RoleGroupCollectionPublic Overridable ReadOnly Property RoleGroups As RoleGroupCollectionValor da propriedade
Um objeto RoleGroupCollection que contém os modelos de grupos de funções definidos.
- Atributos
Exemplos
O exemplo de código a seguir demonstra o uso da RoleGroups coleção. Como as AnonymousTemplate propriedades e LoggedInTemplate não são definidas, o conteúdo é exibido apenas para usuários que pertencem a funções com um modelo de conteúdo definido.
<%@ 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. A coleção na RoleGroups propriedade é pesquisada na ordem em que os modelos são definidos na origem. O primeiro modelo de grupo de funções correspondente é exibido para o usuário. Se um usuário for membro de mais de uma função, o primeiro modelo de grupo de funções que corresponde a qualquer uma das funções do usuário será usado. Se mais de um modelo estiver associado a uma única função, somente o primeiro modelo definido será usado.
Se um usuário conectado não pertencer a nenhuma função contida no conjunto de grupos de funções, o site exibirá o modelo de conteúdo especificado na LoggedInTemplate propriedade . Os usuários anônimos nunca são mostrados em nenhum modelo contido na RoleGroups coleção.
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. Para obter mais informações, consulte Noções básicas sobre o gerenciamento de funções.
Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.
