Roles.GetRolesForUser Methode

Definitie

Naamruimte:: System.Web.Security

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee haalt u een lijst op met de rollen waarin een gebruiker zich bevindt.

Overloads

Name	Description
GetRolesForUser()	Hiermee haalt u een lijst op met de rollen waarin de momenteel aangemelde gebruiker zich bevindt.
GetRolesForUser(String)	Hiermee haalt u een lijst op met de rollen waarin een gebruiker zich bevindt.

GetRolesForUser()

Hiermee haalt u een lijst op met de rollen waarin de momenteel aangemelde gebruiker zich bevindt.

public:
 static cli::array <System::String ^> ^ GetRolesForUser();

public static string[] GetRolesForUser();

static member GetRolesForUser : unit -> string[]

Public Shared Function GetRolesForUser () As String()

Retouren

String[]

Een tekenreeksmatrix met de namen van alle rollen waarin de aangemelde gebruiker zich momenteel bevindt.

Uitzonderingen

ArgumentNullException

Er is geen huidige aangemelde gebruiker.

ProviderException

Rolbeheer is niet ingeschakeld.

Voorbeelden

In het volgende codevoorbeeld wordt de GetRolesForUser methode gebruikt om een lijst met rollen voor een opgegeven gebruiker op te halen en de geretourneerde rollen te binden aan een System.Web.UI.WebControls.GridView besturingselement. Zie voor een voorbeeld van een Web.config-bestand dat rolbeheer Rolesmogelijk maakt.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

string[] rolesArray;

public void Page_Load()
{
  if (!IsPostBack)
  {
    // Bind roles to GridView.

    try
    {
      rolesArray = Roles.GetRolesForUser();
    }
    catch (HttpException e)
    {
      Msg.Text = "There is no current logged on user. Role information cannot be retrieved.";
      return;
    }

    UserRolesGrid.Columns[0].HeaderText = "Roles for " + User.Identity.Name;
    UserRolesGrid.DataSource = rolesArray;
    UserRolesGrid.DataBind();
  }
}

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

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

  <h3>View User Roles</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

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

</form>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Dim rolesArray() As String

Public Sub Page_Load()
  If Not IsPostBack Then
    ' Bind roles to GridView.

    Try
      rolesArray = Roles.GetRolesForUser()
    Catch e As HttpException
      Msg.Text = "There is no current logged on user. Role information cannot be retrieved."
      Return
    End Try

    UserRolesGrid.Columns(0).HeaderText = "Roles for " & User.Identity.Name
    UserRolesGrid.DataSource = rolesArray
    UserRolesGrid.DataBind()
  End If
End Sub

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

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

  <h3>View User Roles</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

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

</form>

</body>
</html>

Opmerkingen

Met GetRolesForUser de methode wordt de RoleProvider.GetRolesForUser methode van de standaardrolprovider aangeroepen om de rollen op te halen uit de gegevensbron waarin de momenteel aangemelde gebruiker zich bevindt. De momenteel aangemelde gebruiker wordt geïdentificeerd door de eigenschap van de HttpContext.User huidige System.Web.HttpContextof Thread.CurrentPrincipal door voor niet-HTTP-hostingomgevingen. Als er geen gebruiker is aangemeld, wordt er een uitzondering gegenereerd. Alleen de rollen voor de toepassing die in de ApplicationName eigenschap is opgegeven, worden opgehaald.

Als CacheRolesInCookie dat het is true, kunnen de resultaten van de GetRolesForUser methode worden geretourneerd vanuit de rolcache in plaats van de opgegeven rolprovider.

Zie ook

Onderstaand ASP.NET rolbeheer

Van toepassing op

GetRolesForUser(String)

Hiermee haalt u een lijst op met de rollen waarin een gebruiker zich bevindt.

public:
 static cli::array <System::String ^> ^ GetRolesForUser(System::String ^ username);

public static string[] GetRolesForUser(string username);

static member GetRolesForUser : string -> string[]

Public Shared Function GetRolesForUser (username As String) As String()

Parameters

username: String

De gebruiker waarvoor een lijst met rollen moet worden geretourneerd.

Retouren

String[]

Een tekenreeksmatrix met de namen van alle rollen waarin de opgegeven gebruiker zich bevindt.

Uitzonderingen

ArgumentNullException

username is null.

ArgumentException

username bevat een komma (,).

ProviderException

Rolbeheer is niet ingeschakeld.

Voorbeelden

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

string[] rolesArray;

public void Page_Load()
{
  if (!IsPostBack)
  {
    // Bind roles to GridView.

    try
    {
      rolesArray = Roles.GetRolesForUser();
    }
    catch (HttpException e)
    {
      Msg.Text = "There is no current logged on user. Role information cannot be retrieved.";
      return;
    }

    UserRolesGrid.Columns[0].HeaderText = "Roles for " + User.Identity.Name;
    UserRolesGrid.DataSource = rolesArray;
    UserRolesGrid.DataBind();
  }
}

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

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

  <h3>View User Roles</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

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

</form>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Dim rolesArray() As String

Public Sub Page_Load()
  If Not IsPostBack Then
    ' Bind roles to GridView.

    Try
      rolesArray = Roles.GetRolesForUser()
    Catch e As HttpException
      Msg.Text = "There is no current logged on user. Role information cannot be retrieved."
      Return
    End Try

    UserRolesGrid.Columns(0).HeaderText = "Roles for " & User.Identity.Name
    UserRolesGrid.DataSource = rolesArray
    UserRolesGrid.DataBind()
  End If
End Sub

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

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

  <h3>View User Roles</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

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

</form>

</body>
</html>

Opmerkingen

Met GetRolesForUser de methode wordt de RoleProvider.GetRolesForUser methode van de standaardrolprovider aangeroepen om de rollen op te halen uit de gegevensbron waarin de gebruiker zich bevindt. Alleen de rollen voor de toepassing die in de ApplicationName eigenschap is opgegeven, worden opgehaald.

Als username deze gelijk is aan de huidige aangemelde gebruiker en CacheRolesInCookie is true, kunnen de resultaten van de GetRolesForUser methode worden geretourneerd vanuit de rolcache in plaats van de opgegeven Provider.

Zie ook

Onderstaand ASP.NET rolbeheer

Van toepassing op

Feedback

Is deze pagina nuttig?