WindowsTokenRoleProvider.GetRolesForUser(String) Methode

Definitie

Naamruimte:
System.Web.Security
Assembly:
System.Web.dll

Hiermee haalt u een lijst op van de Windows groepen waarin een gebruiker zich bevindt.

public:
 override cli::array <System::String ^> ^ GetRolesForUser(System::String ^ username);
public override string[] GetRolesForUser(string username);
override this.GetRolesForUser : string -> string[]
Public Overrides Function GetRolesForUser (username As String) As String()

Parameters

username
String

De gebruiker waarvoor de lijst met Windows groepen moet worden geretourneerd in het formulier DOMEIN\gebruikersnaam.

Retouren

String[]

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

Uitzonderingen

ProviderException

De gebruiker die momenteel wordt uitgevoerd, heeft geen geverifieerde WindowsIdentity koppeling.User Voor niet-HTTP-scenario's heeft de gebruiker die momenteel wordt uitgevoerd, geen geverifieerde WindowsIdentity bijlage.CurrentPrincipal

– of –

username komt niet overeen met de Name huidige WindowsIdentity.

– of –

Er is een fout opgetreden bij het ophalen van de Windows groepsgegevens van de gebruiker.

ArgumentNullException

username is null.

HttpException

Het vertrouwensniveau is kleiner dan Low.

Voorbeelden

In het volgende codevoorbeeld wordt de GetRolesForUser methode gebruikt om een lijst met rollen voor een opgegeven gebruiker op te halen en de lijst met rollen aan een GridView besturingselement te binden. Zie voor een voorbeeld van een Web.config-bestand dat rolbeheer WindowsTokenRoleProvidermogelijk 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()
{
  Msg.Text = "";

  try
  {
    if (!Roles.IsUserInRole(User.Identity.Name, @"BUILTIN\Administrators"))
    {
      Msg.Text = "You are not authorized to view user roles.";
      return;
    }
  }
  catch (HttpException e)
  {
    Msg.Text = "There is no current logged on user. Role membership cannot be verified.";
    return;
  }


  // Bind roles to GridView.

  rolesArray = Roles.GetRolesForUser(User.Identity.Name);
  UserRolesGrid.DataSource = rolesArray;
  UserRolesGrid.DataBind();

  UserRolesGrid.Columns[0].HeaderText = "Roles for " + User.Identity.Name;
}

</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()
  Msg.Text = ""

  Try
    If Not Roles.IsUserInRole(User.Identity.Name, "BUILTIN\Administrators") Then
      Msg.Text = "You are not authorized to view user roles."
      Return
    End If
  Catch e As HttpException
    Msg.Text = "There is no current logged on user. Role membership cannot be verified."
    Return
  End Try

  ' Bind roles to GridView.

  rolesArray = Roles.GetRolesForUser(User.Identity.Name)
  UserRolesGrid.DataSource = rolesArray
  UserRolesGrid.DataBind()

  UserRolesGrid.Columns(0).HeaderText = "Roles for " & User.Identity.Name
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

Deze methode wordt aangeroepen door de klasse Roles om op te halen uit het Windows besturingssysteem een lijst met de Windows groepen waarin de opgegeven gebruiker zich bevindt. De GetRolesForUser methode kan alleen worden aangeroepen voor de momenteel aangemelde gebruiker, zoals aangegeven door de LOGON_USER servervariabele. Als de waarde die is opgegeven in de username parameter niet de naam is van de momenteel aangemelde gebruiker, wordt er een System.Configuration.Provider.ProviderException gegenereerd.

Zie ASP.NET authentication voor meer informatie over een ASP.NET en Windows authentication.

Van toepassing op

Zie ook