Sdílet prostřednictvím

SqlRoleProvider.FindUsersInRole(String, String) Metoda

  • Reference

Definice

Obor názvů:
System.Web.Security
Sestavení:
System.Web.dll

Získá pole uživatelských jmen v roli, kde uživatelské jméno obsahuje zadané uživatelské jméno ke shodě.

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

Parametry

roleName
String

Role, ve které se má hledat.

usernameToMatch
String

Uživatelské jméno, které chcete vyhledat.

Návraty

String[]

Pole řetězců obsahující jména všech uživatelů, u kterých se uživatelské jméno shoduje usernameToMatch a uživatel je členem zadané role.

Výjimky

ArgumentNullException

roleName is null (Nothing v jazyce Visual Basic).

-nebo-

usernameToMatch je null.

ArgumentException

roleName je prázdný řetězec nebo obsahuje čárku.

-nebo-

usernameToMatch je prázdný řetězec.

-nebo-

roleName je delší než 256 znaků.

-nebo-

usernameToMatch je delší než 256 znaků.

ProviderException

roleName nebyla v databázi nalezena.

-nebo-

Při komunikaci s databází došlo k neznámé chybě.

Příklady

Následující příklad kódu používá metodu FindUsersInRole k zobrazení členství v rolích na základě vstupu uživatele. Příklad souboru Web.config, který umožňuje správu rolí, najdete v tématu Roles.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřte, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

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

Poznámky

Metoda FindUsersInRole je volána Roles třídou a vrací seznam uživatelů v roli, kde uživatelské jméno obsahuje shodu zadaného usernameToMatch pro nakonfigurovaný applicationName. Vyhledá SqlRoleProvider uživatelské jméno, které odpovídá hodnotě parametru usernameToMatch pomocí klíčového slova LIKE a podporuje zástupné znaky SQL Serveru. Pokud usernameToMatch je například parametr nastavený na "user1", vrátí se informace o členství uživatele s uživatelským jménem "user1", pokud existuje. usernameToMatch Pokud je parametr nastavený na "user%", vrátí se informace o členství pro uživatele s uživatelským jménem "user1", "user2", "user_admin" atd.

Platí pro

Viz také