.NET Framework Class Library RoleGroup Class Associates a content template in a LoginView control with one or more roles defined for the Web site. This class cannot be inherited.
Inheritance Hierarchy
Namespace:
System.Web.UI.WebControls
Assembly:
System.Web (in System.Web.dll)
Syntax
Public NotInheritable Class RoleGroup
public sealed class RoleGroup
public ref class RoleGroup sealed
[<Sealed>]
type RoleGroup = class end
The RoleGroup type exposes the following members.
Constructors
|
| Name | Description |
|---|
.gif) | RoleGroup | Initializes a new instance of the RoleGroup class. |
Top
Methods
Remarks
You can use the LoginView control to define a set of content templates that contain the content that is displayed to Web site users based on the role assigned by Web site administrators. The RoleGroup class is used by the LoginView control to associate a content template with a set of roles. To dynamically assign a template to the role group, set the ContentTemplate property to a reference to an object that implements the ITemplate interface. You must configure role management to use the RoleGroup class. For more information, see Understanding Role Management.
Examples
The following code example assigns a custom template to the ContentTemplate property.
<%@ 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">
Private Class CustomTemplate
Implements ITemplate
Public Sub InstantiateIn(ByVal container As System.Web.UI.Control) _
Implements System.Web.UI.ITemplate.InstantiateIn
Dim ln As New LoginName
Dim ls As New LoginStatus
Dim lc As New Literal
lc.Text = "<br />"
ln.FormatString = "Welcome, {0}. This line is from the template."
container.Controls.Add(ln)
container.Controls.Add(lc)
container.Controls.Add(ls)
End Sub
End Class
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
Dim rg As New RoleGroup
rg.ContentTemplate = New CustomTemplate
Dim RoleList(1) As String
RoleList(0) = "users"
rg.Roles = RoleList
Dim rgc As RoleGroupCollection = LoginView1.RoleGroups
rgc.Add(rg)
End Sub
</script>
<html >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:LoginView id="LoginView1" runat="server">
<AnonymousTemplate>
You are not logged in.<br />
<asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus>
</AnonymousTemplate>
<LoggedInTemplate>
You are logged in as
<asp:LoginName id="LoginName1" runat="server" />. This message is not from the template.<br />
<asp:LoginStatus id="Loginstatus2" runat="server"></asp:LoginStatus>
</LoggedInTemplate>
</asp:LoginView>
</form>
</body>
</html>
<%@ 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">
private class CustomTemplate : ITemplate
{
public void InstantiateIn(System.Web.UI.Control container)
{
LoginName ln = new LoginName();
LoginStatus ls = new LoginStatus();
Literal lc = new Literal();
lc.Text = "<br />";
ln.FormatString = "Welcome, {0}. This line is from the template.";
container.Controls.Add(ln);
container.Controls.Add(lc);
container.Controls.Add(ls);
}
}
void Page_Load(Object sender, EventArgs e)
{
RoleGroup rg = new RoleGroup();
rg.ContentTemplate = new CustomTemplate();
String[] RoleList = {"users"};
rg.Roles = RoleList;
RoleGroupCollection rgc = LoginView1.RoleGroups;
rgc.Add(rg);
}
</script>
<html >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:LoginView id="LoginView1" runat="server">
<AnonymousTemplate>
You are not logged in.<br />
<asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus>
</AnonymousTemplate>
<LoggedInTemplate>
You are logged in as
<asp:LoginName id="LoginName1" runat="server" />. This message is not from the template.<br />
<asp:LoginStatus id="Loginstatus2" runat="server"></asp:LoginStatus>
</LoggedInTemplate>
</asp:LoginView>
</form>
</body>
</html>
Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
|
Bibliothèque de classes .NET Framework RoleGroup, classe Associe un modèle de contenu dans un contrôle LoginView à un ou plusieurs rôles définis pour le site Web. Cette classe ne peut pas être héritée.
Hiérarchie d'héritage
Espace de noms :
System.Web.UI.WebControls
Assembly :
System.Web (dans System.Web.dll)
Syntaxe
Public NotInheritable Class RoleGroup
public sealed class RoleGroup
public ref class RoleGroup sealed
[<Sealed>]
type RoleGroup = class end
Le type RoleGroup expose les membres suivants.
Constructeurs
|
| Nom | Description |
|---|
| RoleGroup | Initialise une nouvelle instance de la classe RoleGroup. |
Début
Méthodes
Notes
Vous pouvez utiliser le contrôle LoginView pour définir un ensemble de modèles de contenu dont le contenu est affiché aux utilisateurs de site Web selon le rôle assigné par les administrateurs du site Web. La classe RoleGroup est utilisée par le contrôle LoginView pour associer un modèle de contenu à un ensemble de rôles. Pour assigner dynamiquement un modèle au groupe de rôles, définissez la propriété ContentTemplate sur une référence à un objet qui implémente l'interface ITemplate. Vous devez configurer la gestion des rôles pour pouvoir utiliser la classe RoleGroup. Pour plus d'informations, consultez Présentation de la gestion des rôles.
Exemples
L'exemple de code suivant assigne un modèle personnalisé à la propriété ContentTemplate.
<%@ 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">
Private Class CustomTemplate
Implements ITemplate
Public Sub InstantiateIn(ByVal container As System.Web.UI.Control) _
Implements System.Web.UI.ITemplate.InstantiateIn
Dim ln As New LoginName
Dim ls As New LoginStatus
Dim lc As New Literal
lc.Text = "<br />"
ln.FormatString = "Welcome, {0}. This line is from the template."
container.Controls.Add(ln)
container.Controls.Add(lc)
container.Controls.Add(ls)
End Sub
End Class
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
Dim rg As New RoleGroup
rg.ContentTemplate = New CustomTemplate
Dim RoleList(1) As String
RoleList(0) = "users"
rg.Roles = RoleList
Dim rgc As RoleGroupCollection = LoginView1.RoleGroups
rgc.Add(rg)
End Sub
</script>
<html >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:LoginView id="LoginView1" runat="server">
<AnonymousTemplate>
You are not logged in.<br />
<asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus>
</AnonymousTemplate>
<LoggedInTemplate>
You are logged in as
<asp:LoginName id="LoginName1" runat="server" />. This message is not from the template.<br />
<asp:LoginStatus id="Loginstatus2" runat="server"></asp:LoginStatus>
</LoggedInTemplate>
</asp:LoginView>
</form>
</body>
</html>
<%@ 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">
private class CustomTemplate : ITemplate
{
public void InstantiateIn(System.Web.UI.Control container)
{
LoginName ln = new LoginName();
LoginStatus ls = new LoginStatus();
Literal lc = new Literal();
lc.Text = "<br />";
ln.FormatString = "Welcome, {0}. This line is from the template.";
container.Controls.Add(ln);
container.Controls.Add(lc);
container.Controls.Add(ls);
}
}
void Page_Load(Object sender, EventArgs e)
{
RoleGroup rg = new RoleGroup();
rg.ContentTemplate = new CustomTemplate();
String[] RoleList = {"users"};
rg.Roles = RoleList;
RoleGroupCollection rgc = LoginView1.RoleGroups;
rgc.Add(rg);
}
</script>
<html >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:LoginView id="LoginView1" runat="server">
<AnonymousTemplate>
You are not logged in.<br />
<asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus>
</AnonymousTemplate>
<LoggedInTemplate>
You are logged in as
<asp:LoginName id="LoginName1" runat="server" />. This message is not from the template.<br />
<asp:LoginStatus id="Loginstatus2" runat="server"></asp:LoginStatus>
</LoggedInTemplate>
</asp:LoginView>
</form>
</body>
</html>
Informations de version
.NET FrameworkPris en charge dans : 4, 3.5, 3.0, 2.0
Plateformes
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads
Tous les membres static ( Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi
RéférenceAutres ressources
|