RoleGroup Klasse

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ordnet eine Inhaltsvorlage in einem LoginView-Steuerelement einer oder mehreren für die Website definierten Rollen zu. Diese Klasse kann nicht vererbt werden.

public ref class RoleGroup sealed
public sealed class RoleGroup
type RoleGroup = class
Public NotInheritable Class RoleGroup
Vererbung
Object
RoleGroup

Beispiele

Im folgenden Codebeispiel wird der ContentTemplate -Eigenschaft eine benutzerdefinierte Vorlage zugewiesen.

<%@ 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)
    {
        // <Snippet2>
        RoleGroup rg = new RoleGroup();
        rg.ContentTemplate = new CustomTemplate();
        // <Snippet3>
        String[] RoleList = {"users"};
        rg.Roles = RoleList;
        // </Snippet3>
        RoleGroupCollection rgc = LoginView1.RoleGroups;
        rgc.Add(rg);
        // </Snippet2>
    }

</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">
                <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="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)

        ' <Snippet2>
        Dim rg As New RoleGroup
        rg.ContentTemplate = New CustomTemplate
        ' <Snippet3>        
        Dim RoleList(1) As String
        RoleList(0) = "users"
        ' </Snippet3>

        rg.Roles = RoleList

        Dim rgc As RoleGroupCollection = LoginView1.RoleGroups
        rgc.Add(rg)
        ' </Snippet2>
    End Sub
</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">
                <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>

Hinweise

Sie können das LoginView -Steuerelement verwenden, um eine Reihe von Inhaltsvorlagen zu definieren, die den Inhalten enthalten, die websitebenutzern basierend auf der von Websiteadministratoren zugewiesenen Rolle angezeigt werden. Die RoleGroup -Klasse wird vom LoginView -Steuerelement verwendet, um eine Inhaltsvorlage einem Satz von Rollen zuzuordnen.

Um der Rollengruppe dynamisch eine Vorlage zuzuweisen, legen Sie die ContentTemplate -Eigenschaft auf einen Verweis auf ein Objekt fest, das die ITemplate Schnittstelle implementiert.

Sie müssen die Rollenverwaltung für die Verwendung der RoleGroup -Klasse konfigurieren. Weitere Informationen finden Sie unter Grundlegendes zur Rollenverwaltung.

Konstruktoren

RoleGroup()

Initialisiert eine neue Instanz der RoleGroup-Klasse.

Eigenschaften

ContentTemplate

Ruft die dieser Rollengruppe zugeordnete Inhaltsvorlage ab oder legt diese Inhaltsvorlage fest.
Roles

Ruft die dieser Rollengruppe zugeordneten Rollen ab oder legt diese fest.

Methoden

ContainsUser(IPrincipal)

Gibt an, ob der angegebene Benutzer ein Member von einer der Rollen in der Rollengruppe ist.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine durch Trennzeichen getrennte Liste von Rollen zurück, die dieser Rollengruppe zugeordnet sind.

Gilt für:

Weitere Informationen