Membership.FindUsersByEmail Metode

Referensi

Definisi

Ruang nama:: System.Web.Security

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan kumpulan pengguna keanggotaan di mana alamat email berisi alamat email yang ditentukan untuk dicocokkan.

Overload

FindUsersByEmail(String, Int32, Int32, Int32)	Mendapatkan kumpulan pengguna keanggotaan, di halaman data, di mana alamat email berisi alamat email yang ditentukan untuk dicocokkan.
FindUsersByEmail(String)	Mendapatkan kumpulan pengguna keanggotaan di mana alamat email berisi alamat email yang ditentukan untuk dicocokkan.

FindUsersByEmail(String, Int32, Int32, Int32)

Mendapatkan kumpulan pengguna keanggotaan, di halaman data, di mana alamat email berisi alamat email yang ditentukan untuk dicocokkan.

public:
 static System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

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

static member FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public Shared Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parameter

emailToMatch: String

Alamat email yang akan dicari.

pageIndex: Int32

Indeks halaman hasil yang akan dikembalikan. pageIndex berbasis nol.

pageSize: Int32

Ukuran halaman hasil yang akan dikembalikan.

totalRecords: Int32

Jumlah total pengguna yang cocok.

Mengembalikan

MembershipUserCollection

MembershipUserCollection yang berisi halaman pageSizeMembershipUser objek yang dimulai pada halaman yang ditentukan oleh pageIndex.

Pengecualian

ArgumentException

pageIndex kurang dari nol.

-atau-

pageSize kurang dari 1.

Contoh

Contoh kode berikut menggunakan FindUsersByEmail metode untuk mengambil informasi pengguna keanggotaan dari database keanggotaan berdasarkan input pengguna dan menampilkan hasilnya di halaman data.

Penting

Contoh ini berisi kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

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

<%@ 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 pageSize As Integer = 5
Dim totalUsers As Integer
Dim totalPages As Integer
Dim currentPage As Integer = 1

Private Sub GetUsers()
  UserGrid.DataSource = Membership.FindUsersByEmail(EmailTextBox.Text, _
                          currentPage - 1, pageSize, totalUsers)

  totalPages = ((totalUsers - 1) \ pageSize) + 1

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

  If currentPage > totalPages Then
    currentPage = totalPages
    GetUsers()
    Return
  End If

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

  If currentPage = totalPages Then
    NextButton.Visible = False
  Else
    NextButton.Visible = True
  End If

  If currentPage = 1 Then
    PreviousButton.Visible = False
  Else
    PreviousButton.Visible = True
  End If

  If totalUsers <= 0 Then
    NavigationPanel.Visible = False
  Else
    NavigationPanel.Visible = True
  End If
End Sub

Public Sub NextButton_OnClick(sender As Object, args As EventArgs)
  currentPage = Convert.ToInt32(CurrentPageLabel.Text)
  currentPage += 1
  GetUsers()
End Sub

Public Sub PreviousButton_OnClick(sender As Object, args As EventArgs)
  currentPage = Convert.ToInt32(CurrentPageLabel.Text)
  currentPage -= 1
  GetUsers()
End Sub

Public Sub GoButton_OnClick(sender As Object, args As EventArgs)
  currentPage = 1
  GetUsers()
End Sub

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

Keterangan

FindUsersByEmail mengembalikan daftar pengguna keanggotaan di mana alamat email cocok dengan yang disediakan emailToMatch untuk yang dikonfigurasi applicationName.

SqlMembershipProvider melakukan pencariannya menggunakan klausul LIKE terhadap emailToMatch parameter . Kartubebas apa pun yang didukung oleh SQL Server dalam klausa LIKE dapat digunakan dalam emailToMatch nilai parameter.

Hasil yang dikembalikan oleh FindUsersByEmail dibatasi oleh pageIndex parameter dan pageSize . Parameter pageSize mengidentifikasi jumlah MembershipUser maksimum objek yang akan dikembalikan di MembershipUserCollection. Parameter pageIndex mengidentifikasi halaman hasil mana yang akan dikembalikan, di mana 0 mengidentifikasi halaman pertama. Parameter totalRecords adalah out parameter yang diatur ke jumlah total pengguna keanggotaan yang cocok dengan emailToMatch nilai. Misalnya, jika 13 pengguna ditemukan di mana emailToMatch bagian yang cocok dari atau seluruh alamat email, dan pageIndex nilainya adalah 1 dengan pageSize 5, yang MembershipUserCollection dikembalikan akan berisi keenam hingga pengguna kesepuluh yang dikembalikan. totalRecords akan diatur ke 13.

Spasi di depan emailToMatch dan di belakang dipangkas dari nilai parameter.

Lihat juga

Pengantar Keanggotaan ASP.NET

Berlaku untuk

FindUsersByEmail(String)

Mendapatkan kumpulan pengguna keanggotaan di mana alamat email berisi alamat email yang ditentukan untuk dicocokkan.

public:
 static System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch);

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

static member FindUsersByEmail : string -> System.Web.Security.MembershipUserCollection

Public Shared Function FindUsersByEmail (emailToMatch As String) As MembershipUserCollection

Parameter

emailToMatch: String

Alamat email yang akan dicari.

Mengembalikan

MembershipUserCollection

MembershipUserCollection yang berisi semua pengguna yang cocok dengan emailToMatch parameter .

Spasi di depan emailToMatch dan di belakang dipangkas dari nilai parameter.

Contoh

Contoh kode berikut menggunakan FindUsersByEmail metode untuk mengambil informasi pengguna keanggotaan dari database keanggotaan berdasarkan input pengguna dan menampilkan hasilnya di halaman data.

Penting

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

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

Public Sub GoButton_OnClick(sender As Object, args As EventArgs)
  UserGrid.DataSource = Membership.FindUsersByEmail(EmailTextBox.Text)
  UserGrid.DataBind()
End Sub

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

Keterangan

FindUsersByEmail mengembalikan daftar pengguna keanggotaan di mana alamat email cocok dengan yang disediakan emailToMatch untuk yang dikonfigurasi applicationName.

Lihat juga

Pengantar Keanggotaan ASP.NET

Berlaku untuk

Bagikan melalui

Membership.FindUsersByEmail Metode

Definisi

Overload

FindUsersByEmail(String, Int32, Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

FindUsersByEmail(String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: