LoginView.RoleGroups Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
возвращает коллекцию групп ролей для привязки шаблонов содержания к определенным ролям.
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 RoleGroupCollectionЗначение свойства
Объект RoleGroupCollection, содержащий определенные шаблоны групп ролей.
- Атрибуты
Примеры
В следующем примере кода демонстрируется RoleGroups использование коллекции . AnonymousTemplate Так как свойства и LoggedInTemplate не заданы, содержимое отображается только для пользователей, принадлежащих к ролям с определенным шаблоном содержимого.
<%@ 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>
Комментарии
Свойство RoleGroups содержит шаблоны контента, связанные с разными ролями на веб-сайте. Поиск коллекции в свойстве RoleGroups выполняется в порядке, в котором шаблоны определены в источнике. Пользователю отображается первый соответствующий шаблон группы ролей. Если пользователь является членом нескольких ролей, используется первый шаблон группы ролей, соответствующий любой из ролей пользователя. Если с одной ролью связано несколько шаблонов, будет использоваться только первый определенный шаблон.
Если пользователь, выполнивший вход, не принадлежит ни одной роли, содержащейся в семействе ролей, на сайте отображается шаблон контента, указанный в свойстве LoggedInTemplate . Анонимным пользователям никогда не отображается шаблон, содержащийся в RoleGroups коллекции.
Необходимо настроить управление ролями, чтобы использовать RoleGroups свойство для определения шаблонов на основе роли пользователя на веб-сайте. Дополнительные сведения см. в разделе Основные сведения об управлении ролями.
Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.
