2.1.5.5 FindUsersByEmail
このメソッドは、指定された電子メール・アドレスに一致する電子メール・アドレスを持つユーザーのコレクションを戻します。
宣言
// C# public override MembershipUserCollection FindUsersByEmail(string emailToMatch, int pageIndex, int pageSize, out int totalRecords);
パラメータ
-
emailToMatch
検索する電子メール・アドレス。
-
pageIndex
戻す結果のページの索引。
PageIndex
はゼロベースです。 -
pageSize
戻す結果のページ・サイズ。
-
totalRecords
一致するユーザーの総数。
戻り値
MembershipUser
オブジェクトを含むMembershipUserCollection
オブジェクトを戻します。
例外
ArgumentException
- 次のいずれかの条件が存在します。
-
emailToMatch
パラメータが空の文字列であるか、256文字を超えています。 -
pageIndex
パラメータが0未満です。 -
pageSize
パラメータが1未満であるか、ページ上限がInt32.MaxValue
を超えています。
ArgumentNullException
- emailToMatch
、pageIndex
、pageSize
またはtotalRecords
パラメータがnullです。
備考
先頭および末尾の空白はemailToMatch
パラメータ値から削除されます。FindUsersByEmail
メソッドから戻される結果は、pageIndex
パラメータとpageSize
パラメータによって制約されます。pageSize
パラメータは、MembershipUserCollection
オブジェクトで戻すMembershipUser
オブジェクトの最大数を示します。pageIndex
パラメータは、結果のどのページを戻すかを示します。値はゼロベースであるため、ゼロは最初のページを示します。totalRecords
パラメータは、emailToMatch
値に一致したユーザーの総数を表す出力パラメータです。
OracleMembershipProvider
クラスは、パーセント文字(%)をワイルドカードとして受け入れることにより、拡張検索をサポートします。