SqlRoleProvider.FindUsersInRole(String, String) 메서드

정의

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

사용자 이름에 일치시킬 지정된 사용자 이름이 포함된 역할의 사용자 이름 배열을 가져옵니다.

public:
 override cli::array <System::String ^> ^ FindUsersInRole(System::String ^ roleName, System::String ^ usernameToMatch);
public override string[] FindUsersInRole(string roleName, string usernameToMatch);
override this.FindUsersInRole : string * string -> string[]
Public Overrides Function FindUsersInRole (roleName As String, usernameToMatch As String) As String()

매개 변수

roleName
String

검색할 역할입니다.

usernameToMatch
String

검색할 사용자 이름입니다.

반품

String[]

사용자 이름이 일치 usernameToMatch 하고 사용자가 지정된 역할의 멤버인 모든 사용자의 이름을 포함하는 문자열 배열입니다.

예외

ArgumentNullException

roleName는 (nullVisual Basic에서)입니다 Nothing .

-또는-

usernameToMatch은 null입니다.

ArgumentException

roleName 은 빈 문자열이거나 쉼표가 포함되어 있습니다.

-또는-

usernameToMatch 은 빈 문자열입니다.

-또는-

roleName 가 256자보다 깁니다.

-또는-

usernameToMatch 가 256자보다 깁니다.

ProviderException

roleName 을(를) 데이터베이스에서 찾을 수 없습니다.

-또는-

데이터베이스와 통신하는 동안 알 수 없는 오류가 발생했습니다.

예제

다음 코드 예제에서는 메서드를 FindUsersInRole 사용하여 사용자 입력에 따라 역할 멤버 자격을 표시합니다. 역할 관리를 사용하도록 설정하는 Web.config 파일의 예는 다음을 참조하세요 Roles.

Important

이 예제에는 잠재적인 보안 위협인 사용자 입력을 허용하는 텍스트 상자가 포함되어 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력에 스크립트 또는 HTML 요소가 포함되지 않는지 확인합니다. 자세한 내용은 스크립트 악용 개요를 참조하세요.

<%@ 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[] users;

public void Page_Load()
{
  if (!IsPostBack)
  {
    RolesListBox.DataSource = Roles.GetAllRoles();
    RolesListBox.DataBind();
  }
}

public void GoButton_OnClick(object sender, EventArgs args)
{
  Msg.Text = "";
  users = null;

  if (RolesListBox.SelectedItem == null)
  {
    Msg.Text = "Please select a role.";
    return;
  }

  users = Roles.FindUsersInRole(RolesListBox.SelectedItem.Text, UsernameTextBox.Text);

  if (users.Length < 1)
  {
    Msg.Text = "No matching users found in selected role.";
  }

  UserGrid.DataSource = users;
  UserGrid.DataBind();
}

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

<form id="form1" runat="server">
  <h3>User List</h3>

  <asp:Label id="Msg" runat="Server" ForeColor="red" />

  <table border="0" cellpadding="3" cellspacing="3">
    <tr>
      <td valign="top">Role:</td>
      <td valign="top"><asp:ListBox id="RolesListBox" runat="Server" /></td>
    </tr>
    <tr>
      <td valign="top">Username to Search for:</td>
      <td valign="top"><asp:TextBox id="UsernameTextBox" runat="server" /></td>
    </tr>
  </table>
  <asp:Button id="GoButton" Text=" Go " OnClick="GoButton_OnClick" runat="server" /><br />

  <asp:DataGrid id="UserGrid" runat="server"
                CellPadding="2" CellSpacing="1"
                Gridlines="Both">
    <HeaderStyle BackColor="darkblue" ForeColor="white" />
  </asp:DataGrid>

</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 users() As String

Public Sub Page_Load()
  If Not IsPostBack Then
    RolesListBox.DataSource = Roles.GetAllRoles()
    RolesListBox.DataBind()
  End If
End SUb

Public Sub GoButton_OnClick(sender As Object, args As EventArgs)
  Msg.Text = ""
  users = Nothing

  If RolesListBox.SelectedItem Is Nothing Then
    Msg.Text = "Please select a role."
    Return
  End If

  users = Roles.FindUsersInRole(RolesListBox.SelectedItem.Text, UsernameTextBox.Text)

  If users.Length < 1 Then
    Msg.Text = "No matching users found in selected role."
  End If

  UserGrid.DataSource = users
  UserGrid.DataBind()
End Sub

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

<form id="form1" runat="server">
  <h3>User List</h3>

  <asp:Label id="Msg" runat="Server" ForeColor="red" />

  <table border="0" cellpadding="3" cellspacing="3">
    <tr>
      <td valign="top">Role:</td>
      <td valign="top"><asp:ListBox id="RolesListBox" runat="Server" /></td>
    </tr>
    <tr>
      <td valign="top">Username to Search for:</td>
      <td valign="top"><asp:TextBox id="UsernameTextBox" runat="server" /></td>
    </tr>
  </table>
  <asp:Button id="GoButton" Text=" Go " OnClick="GoButton_OnClick" runat="server" /><br />

  <asp:DataGrid id="UserGrid" runat="server"
                CellPadding="2" CellSpacing="1"
                Gridlines="Both">
    <HeaderStyle BackColor="darkblue" ForeColor="white" />
  </asp:DataGrid>

</form>

</body>
</html>

설명

이 메서드는 FindUsersInRole 클래스에서 Roles 호출되며 사용자 이름에 구성된 usernameToMatch사용자에 대해 제공된 applicationName 일치 항목이 포함된 역할의 사용자 목록을 반환합니다. SqlRoleProvider LIKE 키워드를 사용하여 usernameToMatch 매개 변수 값과 일치하는 사용자 이름을 검색하고 SQL Server 와일드카드 문자를 지원합니다. 예를 들어 매개 변수가 usernameToMatch "user1"로 설정된 경우 사용자 이름이 "user1"인 사용자의 멤버 자격 정보가 반환됩니다(있는 경우). 매개 변수가 usernameToMatch "user%"로 설정된 경우 사용자 이름이 "user1", "user2", "user_admin" 등인 사용자의 멤버 자격 정보가 반환됩니다.

적용 대상

추가 정보