SqlRoleProvider.FindUsersInRole(String, String) Método

Referência

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém uma matriz de nomes de usuário em uma função em que o nome de usuário contém o nome de usuário especificado para corresponder.

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

Parâmetros

roleName: String

A função a ser pesquisada.

usernameToMatch: String

O nome de usuário a ser pesquisado.

Retornos

String[]

Uma matriz de cadeia de caracteres que contém os nomes de todos os usuários cujo nome de usuário corresponde usernameToMatch e o usuário é um membro da função especificada.

Exceções

ArgumentNullException

roleName é null (Nothing no Visual Basic).

- ou -

usernameToMatch é null.

ArgumentException

roleName é uma cadeia de caracteres vazia ou contém uma vírgula.

- ou -

usernameToMatch é uma cadeia de caracteres vazia.

- ou -

roleName tem mais de 256 caracteres.

- ou -

usernameToMatch tem mais de 256 caracteres.

ProviderException

roleName não foi encontrado no banco de dados.

- ou -

Erro desconhecido durante a comunicação com o banco de dados.

Exemplos

O exemplo de código a seguir usa o FindUsersInRole método para exibir a associação de função com base na entrada do usuário. Para obter um exemplo de um arquivo de Web.config que habilita o gerenciamento de funções, consulte Roles.

Importante

Este exemplo contém uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

O FindUsersInRole método é chamado pela Roles classe e retorna uma lista de usuários em uma função em que o nome de usuário contém uma correspondência do fornecido usernameToMatch para o configurado applicationName. O SqlRoleProvider pesquisa um nome de usuário que corresponde ao valor do usernameToMatch parâmetro usando a palavra-chave LIKE e dá suporte a caracteres curinga do SQL Server. Por exemplo, se o usernameToMatch parâmetro for definido como "user1", as informações de associação do usuário com o nome de usuário "user1" serão retornadas, se existirem. Se o usernameToMatch parâmetro for definido como "user%", as informações de associação para usuários com o nome de usuário "user1", "user2", "user_admin" e assim por diante serão retornadas.

Aplica-se a

Confira também

Noções básicas sobre ASP.NET gerenciamento de funções

Compartilhar via

SqlRoleProvider.FindUsersInRole(String, String) Método

Definição

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Confira também

Comentários

Recursos adicionais