Membership.FindUsersByEmailとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

Membership.FindUsersByEmail メソッド (String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

電子メール アドレスが指定内容と一致するメンバシップ ユーザーのコレクションを取得します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文構文

Visual Basic (宣言)
Public Shared Function FindUsersByEmail
 ( _
    emailToMatch As String _
) As MembershipUserCollection
Visual Basic (使用法)
Dim emailToMatch As String
Dim returnValue As MembershipUserCollection

returnValue = Membership.FindUsersByEmail(emailToMatch)
C#
public static MembershipUserCollection FindUsersByEmail
 (
    string emailToMatch
)
C++
public:
static MembershipUserCollection^ FindUsersByEmail (
    String^ emailToMatch
)
J#
public static MembershipUserCollection FindUsersByEmail
 (
    String emailToMatch
)
JScript
public static function FindUsersByEmail
 (
    emailToMatch : String
) : MembershipUserCollection

パラメータ

emailToMatch

検索対象の電子メール アドレス。

戻り値
emailToMatch パラメータと一致するすべてのユーザーが含まれる MembershipUserCollection。 emailToMatch パラメータ値の先頭と末尾の空白はトリムされます。

解説解説

FindUsersByEmail は、構成された applicationName に対して指定された emailToMatch に一致する電子メール アドレスを持つメンバシップ ユーザーの一覧を返します。

SqlMembershipProvider は、emailToMatch パラメータに対して LIKE 句を使用した検索を実行します。SQL Server の LIKE 句でサポートされる任意のワイルドカードを emailToMatch パラメータの値に使用できます。

使用例使用例

FindUsersByEmail メソッドを使用し、ユーザー入力に基づいてメンバシップ データベースからメンバシップ ユーザー情報を取得し、その結果をデータのページに表示するコード例を次に示します。

Visual Basic
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<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>
<head>
<title>Sample: Find Users by Email</title>
</head>
<body>

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

  E-mail 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>
C#
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

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

</script>
<html>
<head>
<title>Sample: Find Users by Email</title>
</head>
<body>

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

  E-mail 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>
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Membership クラス
Membership メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要
メンバシップの概要

Membership.FindUsersByEmail メソッド (String, Int32, Int32, Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

電子メール アドレスが指定内容と一致するメンバシップ ユーザーのコレクションをページで取得します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文構文

Visual Basic (宣言)
Public Shared Function FindUsersByEmail
 ( _
    emailToMatch As String, _
    pageIndex As Integer, _
    pageSize As Integer, _
    <OutAttribute> ByRef totalRecords As
 Integer _
) As MembershipUserCollection
Visual Basic (使用法)
Dim emailToMatch As String
Dim pageIndex As Integer
Dim pageSize As Integer
Dim totalRecords As Integer
Dim returnValue As MembershipUserCollection

returnValue = Membership.FindUsersByEmail(emailToMatch, pageIndex, pageSize, totalRecords)
C#
public static MembershipUserCollection FindUsersByEmail
 (
    string emailToMatch,
    int pageIndex,
    int pageSize,
    out int totalRecords
)
C++
public:
static MembershipUserCollection^ FindUsersByEmail (
    String^ emailToMatch, 
    int pageIndex, 
    int pageSize, 
    [OutAttribute] int% totalRecords
)
J#
public static MembershipUserCollection FindUsersByEmail
 (
    String emailToMatch, 
    int pageIndex, 
    int pageSize, 
    /** @attribute OutAttribute() */ /** @ref */ int totalRecords
)
JScript
JScript では、値型の引数は参照渡しされません。

パラメータ

emailToMatch

検索対象の電子メール アドレス。

pageIndex

取得する結果のページのインデックス。pageIndex は 0 から始まります。

pageSize

取得する結果のページのサイズ。

totalRecords

一致したユーザーの総数。

戻り値
pageIndex で指定されたページから始まる pageSizeMembershipUser オブジェクトのページを格納している MembershipUserCollection。

例外例外
例外の種類条件

ArgumentException

pageIndex が 0 未満です。

または

pageSize が 1 未満です。

解説解説

FindUsersByEmail は、構成された applicationName に対して指定された emailToMatch に一致する電子メール アドレスを持つメンバシップ ユーザーの一覧を返します。

SqlMembershipProvider は、emailToMatch パラメータに対して LIKE 句を使用した検索を実行します。SQL Server の LIKE 句でサポートされる任意のワイルドカードを emailToMatch パラメータの値に使用できます。

FindUsersByEmail によって返される結果は、pageIndex パラメータおよび pageSize パラメータによって制限されます。pageSize パラメータには、MembershipUserCollection で返す MembershipUser オブジェクトの最大数を指定します。pageIndex パラメータは、取得する結果のページを識別します。最初のページは 0 で表されます。totalRecords パラメータは、emailToMatch 値と一致するメンバシップ ユーザーの総数に設定された out パラメータです。たとえば、電子メール アドレスの一部または全体が emailToMatch と一致するユーザーが 13 人見つかり、pageSize が 5 で pageIndex 値が 1 であった場合、返される MembershipUserCollection には、返される 6 番目から 10 番目のユーザーが含まれます。totalRecords は 13 に設定されます。

emailToMatch パラメータ値の先頭と末尾の空白はトリムされます。

使用例使用例

FindUsersByEmail メソッドを使用し、ユーザー入力に基づいてメンバシップ データベースからメンバシップ ユーザー情報を取得し、その結果をデータのページに表示するコード例を次に示します。

Visual Basic
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<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.FindUsersByName(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>
<head>
<title>Sample: Find Users by Email</title>
</head>
<body>

<form 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 width=100>Page <asp:Label id="CurrentPageLabel"
 runat="server" />
            of <asp:Label id="TotalPagesLabel"
 runat="server" /></td>
        <td width=60><asp:LinkButton id="PreviousButton"
 Text="< Prev"
                            OnClick="PreviousButton_OnClick"
 runat="server" /></td>
        <td 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>
C#
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<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>
<head>
<title>Sample: Find Users by Email</title>
</head>
<body>

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

  E-mail 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 width=100>Page <asp:Label id="CurrentPageLabel" runat="server"
 />
            of <asp:Label id="TotalPagesLabel" runat="server"
 /></td>
        <td width=60><asp:LinkButton id="PreviousButton" Text="<
 Prev"
                            OnClick="PreviousButton_OnClick" runat="server"
 /></td>
        <td 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>
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Membership クラス
Membership メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

Membership.FindUsersByEmail メソッド

電子メール アドレスが指定内容と一致するメンバシップ ユーザーのコレクションを取得します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
Membership.FindUsersByEmail (String) 電子メール アドレスが指定内容と一致するメンバシップ ユーザーのコレクションを取得します。
Membership.FindUsersByEmail (String, Int32, Int32, Int32) 電子メール アドレスが指定内容と一致するメンバシップ ユーザーのコレクションをページで取得します。
参照参照

関連項目

Membership クラス
Membership メンバ
System.Web.Security 名前空間

その他の技術情報

メンバシップの概要
メンバシップの概要
メンバシップの概要

急上昇のことば

顕著
開けゴマ
センテンススプリング
十三人評議会
検討
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「Membership.FindUsersByEmail」の関連用語

1
Membership.FindUsersByEmail メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

2
SqlMembershipProvider.FindUsersByEmail メソッド
.NET Framework クラス ライブラリ リファレンス
12% |||||

Membership.FindUsersByEmailのお隣キーワード

Membership.CreateUser メソッド

Membership.DeleteUser メソッド

Membership.EnablePasswordReset プロパティ

Membership.EnablePasswordRetrieval プロパティ

Membership.FindUsersByEmail

Membership.FindUsersByEmail メソッド

Membership.FindUsersByName メソッド

Membership.GeneratePassword メソッド

Membership.GetAllUsers メソッド

Membership.GetNumberOfUsersOnline メソッド

Membership.GetUser メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


Membership.FindUsersByEmailのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS