MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) 方法

定义

命名空间:

System.Web.Security

程序集:

System.Web.ApplicationServices.dll

获取一个成员资格用户的集合，其中的用户名包含要匹配的指定用户名。

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

参数

usernameToMatch

String

要搜索的用户名。

pageIndex

Int32

要返回的结果页的索引。 pageIndex 从零开始。

pageSize

Int32

要返回的结果页的大小。

totalRecords

Int32

匹配用户的总数。

返回

MembershipUserCollection

包含一页 pageSizeMembershipUser 对象的 MembershipUserCollection 集合，这些对象从 pageIndex 指定的页开始。

示例

有关实现的示例 MembershipProvider ，请参阅 实现配置文件提供程序。

注解

FindUsersByName返回成员身份用户的列表，其中用户名与为配置ApplicationName的属性提供的 usernameToMatch 匹配。 如果数据源支持其他搜索功能（如通配符），则可以为用户名提供更广泛的搜索功能。

返回 FindUsersByName 的结果受 pageIndex 和 pageSize 参数的约束。 参数pageSize标识集合中MembershipUserCollection要返回的对象数MembershipUser。 参数 pageIndex 标识要返回的结果页，其中 0 标识第一页。 参数 totalRecords 是一个 out 参数，它设置为与值匹配 usernameToMatch 的成员身份用户总数。 例如，如果找到 13 个用户，其中 usernameToMatch 匹配部分或整个用户名，并且 pageIndex 值为 1，值为 pageSize 5，则 MembershipUserCollection 将包含返回的第六个到第十个用户。 totalRecords 将 设置为 13。

另请参阅

• 实现成员资格提供程序
• ASP.NET 成员资格简介