LoginView.RoleGroups Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá kolekci skupin rolí, které přidružují šablony obsahu k určitým rolím.
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
Hodnota vlastnosti
Objekt RoleGroupCollection , který obsahuje definované šablony skupin rolí.
- Atributy
Příklady
Následující příklad kódu ukazuje použití RoleGroups kolekce. Vzhledem k tomu, že vlastnosti AnonymousTemplate LoggedInTemplate nejsou nastavené, obsah se zobrazí jenom uživatelům, kteří patří do rolí s definovanou šablonou obsahu.
<%@ 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>
Poznámky
Vlastnost RoleGroups obsahuje šablony obsahu přidružené k různým rolím na webu. Kolekce ve RoleGroups vlastnosti je prohledána v pořadí, ve kterém jsou šablony definovány ve zdroji. Uživateli se zobrazí první odpovídající šablona skupiny rolí. Pokud je uživatel členem více rolí, použije se první šablona skupiny rolí, která odpovídá některé z rolí uživatele. Pokud je k jedné roli přidruženo více než jedna šablona, použije se pouze první definovaná šablona.
Pokud přihlášený uživatel nepatří do žádné role obsažené v kolekci skupin rolí, web zobrazí šablonu obsahu zadanou ve LoggedInTemplate vlastnosti. Anonymní uživatelé se nikdy nezobrazují žádná šablona obsažená v kolekci RoleGroups .
Správu rolí musíte nakonfigurovat tak, aby používala RoleGroups vlastnost k definování šablon na základě role uživatele na webu. Další informace najdete v tématu Principy správy rolí.
Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématech ThemeableAttribute a skinech a ASP.NET.