Membership.FindUsersByEmail Método

Definição

Obtém uma coleção de usuários associados na qual o endereço de email contém o endereço de email especificado a ser correspondido.

Sobrecargas

FindUsersByEmail(String, Int32, Int32, Int32)

Obtém uma coleção de usuários associados em uma página de dados, em que o endereço de email contém o endereço de email de correspondência especificado.

FindUsersByEmail(String)

Obtém uma coleção de usuários associados na qual o endereço de email contém o endereço de email especificado a ser correspondido.

FindUsersByEmail(String, Int32, Int32, Int32)

Obtém uma coleção de usuários associados em uma página de dados, em que o endereço de email contém o endereço de email de correspondência especificado.

public static System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch, int pageIndex, int pageSize, out int totalRecords);

Parâmetros

emailToMatch
String

O endereço de email a ser pesquisado.

pageIndex
Int32

O índice da página de resultados a serem retornados. pageIndex é baseado em zero.

pageSize
Int32

O tamanho da página de resultados a ser retornada.

totalRecords
Int32

O número total de usuários correspondentes.

Retornos

Um MembershipUserCollection que contém uma página de objetos pageSizeMembershipUser começando na página especificada por pageIndex.

Exceções

pageIndex é menor que zero.

- ou -

pageSize é menor que 1.

Exemplos

O exemplo de código a seguir usa o FindUsersByEmail método para recuperar informações do usuário associado do banco de dados de associação com base na entrada do usuário e exibe os resultados em páginas de dados.

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">

int pageSize = 5;
int totalUsers;
int totalPages;
int currentPage = 1;

private void GetUsers()
{
  UserGrid.DataSource = Membership.FindUsersByEmail(EmailTextBox.Text, 
                          currentPage - 1, pageSize, out totalUsers);
  totalPages = ((totalUsers - 1) / pageSize) + 1;

  // Ensure that we do not navigate past the last page of users.

  if (currentPage > totalPages)
  {
    currentPage = totalPages;
    GetUsers();
    return;
  }

  UserGrid.DataBind();
  CurrentPageLabel.Text = currentPage.ToString();
  TotalPagesLabel.Text = totalPages.ToString();

  if (currentPage == totalPages)
    NextButton.Visible = false;
  else
    NextButton.Visible = true;

  if (currentPage == 1)
    PreviousButton.Visible = false;
  else
    PreviousButton.Visible = true;

  if (totalUsers <= 0)
    NavigationPanel.Visible = false;
  else
    NavigationPanel.Visible = true;
}

public void NextButton_OnClick(object sender, EventArgs args)
{
  currentPage = Convert.ToInt32(CurrentPageLabel.Text);
  currentPage++;
  GetUsers();
}

public void PreviousButton_OnClick(object sender, EventArgs args)
{
  currentPage = Convert.ToInt32(CurrentPageLabel.Text);
  currentPage--;
  GetUsers();
}

public void GoButton_OnClick(object sender, EventArgs args)
{
  currentPage = 1;
  GetUsers();
}

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

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

  Email address to Search for: 
    <asp:TextBox id="EmailTextBox" runat="server" />
    <asp:Button id="GoButton" Text=" Go " OnClick="GoButton_OnClick" runat="server" /><br />

  <asp:Panel id="NavigationPanel" Visible="false" runat="server">
    <table border="0" cellpadding="3" cellspacing="3">
      <tr>
        <td style="width:100">Page <asp:Label id="CurrentPageLabel" runat="server" />
            of <asp:Label id="TotalPagesLabel" runat="server" /></td>
        <td style="width:60"><asp:LinkButton id="PreviousButton" Text="< Prev"
                            OnClick="PreviousButton_OnClick" runat="server" /></td>
        <td style="width:60"><asp:LinkButton id="NextButton" Text="Next >"
                            OnClick="NextButton_OnClick" runat="server" /></td>
      </tr>
    </table>
  </asp:Panel>

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

</form>

</body>
</html>

Comentários

FindUsersByEmail retorna uma lista de usuários associados em que o endereço de email corresponde ao fornecido emailToMatch para o configurado applicationName.

O SqlMembershipProvider executa sua pesquisa usando uma cláusula LIKE em relação ao emailToMatch parâmetro . Todos os curingas compatíveis com o SQL Server em cláusulas LIKE podem ser usados no valor do emailToMatch parâmetro.

Os resultados retornados por FindUsersByEmail são restritos pelos pageIndex parâmetros e pageSize . O pageSize parâmetro identifica o número máximo de MembershipUser objetos a serem retornados no MembershipUserCollection. O pageIndex parâmetro identifica qual página de resultados retornar, em que 0 identifica a primeira página. O totalRecords parâmetro é um out parâmetro definido como o número total de usuários associados que corresponderam ao emailToMatch valor. Por exemplo, se 13 usuários foram encontrados onde emailToMatch a parte correspondente ou o endereço de email inteiro e o pageIndex valor era 1 com um pageSize de 5, o MembershipUserCollection retornado conteria o sexto ao décimo usuário retornado. totalRecords seria definido como 13.

Os espaços à esquerda e à direita são cortados do valor de parâmetro emailToMatch.

Confira também

Aplica-se a

FindUsersByEmail(String)

Obtém uma coleção de usuários associados na qual o endereço de email contém o endereço de email especificado a ser correspondido.

public static System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch);

Parâmetros

emailToMatch
String

O endereço de email a ser pesquisado.

Retornos

Um MembershipUserCollection que contém todos os usuários que correspondem ao parâmetro emailToMatch.

Os espaços à esquerda e à direita são cortados do valor de parâmetro emailToMatch.

Exemplos

O exemplo de código a seguir usa o FindUsersByEmail método para recuperar informações do usuário associado do banco de dados de associação com base na entrada do usuário e exibe os resultados em páginas de dados.

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">

public void GoButton_OnClick(object sender, EventArgs args)
{
  UserGrid.DataSource = Membership.FindUsersByEmail(EmailTextBox.Text);
  UserGrid.DataBind();
}

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

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

  Email address to Search for: 
    <asp:TextBox id="EmailTextBox" runat="server" />
    <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

FindUsersByEmail retorna uma lista de usuários associados em que o endereço de email corresponde ao fornecido emailToMatch para o configurado applicationName.

O SqlMembershipProvider executa sua pesquisa usando uma cláusula LIKE em relação ao emailToMatch parâmetro . Todos os curingas compatíveis com o SQL Server em cláusulas LIKE podem ser usados no valor do emailToMatch parâmetro.

Confira também

Aplica-se a