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

定義

指定したメール アドレスと一致するメール アドレスを持つメンバーシップ ユーザーのコレクションを取得します。

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public MustOverride Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

パラメーター

emailToMatch
String

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

pageIndex
Int32

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

pageSize
Int32

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

totalRecords
Int32

一致したユーザーの合計数。

戻り値

pageIndex によって指定されたページから始まる、pageSizeMembershipUser オブジェクトのページを含む MembershipUserCollection コレクション。

実装の例については、「プロファイル プロバイダーMembershipProvider実装」を参照してください。

注釈

FindUsersByEmailは、ユーザーの電子メール アドレスが、構成されたApplicationNameプロパティに指定された emailToMatch と一致するメンバーシップ ユーザーの一覧を返します。 データ ソースでワイルドカード文字などの追加の検索機能がサポートされている場合は、メール アドレスに対してより広範な検索機能を提供できます。

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

適用対象

こちらもご覧ください