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