Share via

WindowsTokenRoleProvider.GetRolesForUser(String) 메서드

  • 참조

정의

네임스페이스:
System.Web.Security
어셈블리:
System.Web.dll

사용자가 속한 Windows 그룹 목록을 가져옵니다.

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()

매개 변수

username
String

Windows 그룹 목록을 반환할 DOMAIN\username 형태의 사용자입니다.

반환

String[]

지정된 사용자가 속한 모든 Windows 그룹의 이름이 포함된 문자열 배열입니다.

예외

ProviderException

현재 실행 중인 사용자가 WindowsIdentity에 연결된 인증된 User를 갖고 있지 않은 경우. HTTP 이외의 시나리오에서는 현재 실행 중인 사용자가 WindowsIdentity에 연결된 인증된 CurrentPrincipal를 갖고 있지 않습니다.

또는

username이 현재 Name의 WindowsIdentity과 일치하지 않는 경우

또는

사용자의 Windows 그룹 정보를 검색하는 동안 실패가 발생한 경우

ArgumentNullException

username이(가) null인 경우

HttpException

현재 신뢰 수준이 Low보다 낮은 경우

예제

다음 코드 예제에서는 GetRolesForUser 지정 된 사용자 역할의 목록을 검색 하는 방법 및 역할을 목록을 바인딩하고 GridView 컨트롤입니다. 역할 관리를 사용 하도록 설정 하는 Web.config 파일의 예제를 참조 하세요. WindowsTokenRoleProvider합니다.

<%@ 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>

설명

이 메서드는 Roles Windows 운영 체제에서 지정 된 사용자가 Windows 그룹 목록을 검색 하는 클래스입니다. GetRolesForUser LOGON_USER 서버 변수에서 식별 한 대로 현재 로그인 한 사용자에 대해서만 메서드를 호출할 수 있습니다. 제공 된 값을 username 매개 변수는 현재 로그인 한 사용자의 이름이 아닙니다.는 System.Configuration.Provider.ProviderException throw 됩니다.

자세한 내용은 ASP.NET 및 Windows 인증을 참조 하세요 ASP.NET 인증합니다.

적용 대상

추가 정보