RolePrincipal.GetRoles Methode

  • Referenz

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Ruft eine Liste der Rollen ab, denen RolePrincipal als Member angehört.

public:
 cli::array <System::String ^> ^ GetRoles();
public string[] GetRoles ();
member this.GetRoles : unit -> string[]
Public Function GetRoles () As String()

Gibt zurück

String[]

Die Liste der Rollen, denen RolePrincipal als Member angehört.

Ausnahmen

ProviderException

Die Identity-Eigenschaft ist null.

Beispiele

Im folgenden Codebeispiel werden die Rollen angezeigt, denen der angemeldete Benutzer angehört.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

string[] rolesArray;

public void Page_Load()
{
  RolePrincipal r = (RolePrincipal)User;
  rolesArray = r.GetRoles();
  UserRolesGrid.DataSource = rolesArray;
  UserRolesGrid.DataBind();

  Heading.Text = "Roles for " + User.Identity.Name;
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Sample: View Roles</title>
</head>
<body>

<form runat="server" id="PageForm">

  <h3><asp:Label id="Heading" runat="server" /></h3>

  <table border="0" cellspacing="4">
    <tr>
      <td valign="top"><asp:GridView runat="server" CellPadding="4" id="UserRolesGrid" 
                                     AutoGenerateColumns="false" Gridlines="None" 
                                     CellSpacing="0" >
                         <Columns>
                           <asp:TemplateField >
                             <ItemTemplate>
                               <%# Container.DataItem.ToString() %>
                             </ItemTemplate>
                           </asp:TemplateField>
                         </Columns>
                       </asp:GridView></td>
    </tr>
  </table>

</form>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

Dim rolesArray() As String

Public Sub Page_Load()
  Dim r As RolePrincipal = CType(User, RolePrincipal)
  rolesArray = r.GetRoles()
  UserRolesGrid.DataSource = rolesArray
  UserRolesGrid.DataBind()

  Heading.Text = "Roles for " & User.Identity.Name
End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Sample: View Roles</title>
</head>
<body>

<form runat="server" id="PageForm">

  <h3><asp:Label id="Heading" runat="server" /></h3>

  <table border="0" cellspacing="4">
    <tr>
      <td valign="top"><asp:GridView runat="server" CellPadding="4" id="UserRolesGrid" 
                                     AutoGenerateColumns="false" Gridlines="None" 
                                     CellSpacing="0" >
                         <Columns>
                           <asp:TemplateField >
                             <ItemTemplate>
                               <%# Container.DataItem.ToString() %>
                             </ItemTemplate>
                           </asp:TemplateField>
                         </Columns>
                       </asp:GridView></td>
    </tr>
  </table>

</form>

</body>
</html>

Hinweise

Wenn CacheRolesInCookie ist true und Rollennamen für den durch RolePrincipaldargestellten Benutzer zwischengespeichert wurden, gibt die GetRoles -Methode die Liste der Rollennamen im Cache zurück, dem der Benutzer angehört. Wenn Rollennamen nicht zwischengespeichert wurden, gibt die Methode die GetRoles Liste der Rollennamen zurück, die der Benutzer aus der Standardrolle Providerist. Es werden nur Rollennamen für den aktuellen ApplicationName zurückgegeben. Überprüfen Sie die RolePrincipalIsRoleListCached -Eigenschaft, um festzustellen, ob Rollennamen im Objekt zwischengespeichert wurden.

Gilt für:

Weitere Informationen