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 从零开始。

pageSize
Int32

要返回的结果页的大小。

totalRecords
Int32

匹配用户的总数。

返回

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

示例

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

注解

FindUsersByEmail返回成员身份用户的列表,其中用户的电子邮件地址与为配置ApplicationName的属性提供的 emailToMatch 匹配。 如果数据源支持其他搜索功能(如通配符),则可以为电子邮件地址提供更广泛的搜索功能。

返回 FindUsersByEmail 的结果受 pageIndexpageSize 参数的约束。 参数pageSize标识集合中MembershipUserCollection要返回的对象数MembershipUser。 参数 pageIndex 标识要返回的结果页,其中 0 标识第一页。 参数 totalRecords 是一个 out 参数,它设置为与值匹配 emailToMatch 的成员身份用户总数。 例如,如果在匹配部分或整个电子邮件地址的位置 emailToMatch 找到 13 个用户,并且 pageIndex 值为 1,值为 pageSize 5,则 MembershipUserCollection 将包含返回的第六个到第十个用户。 totalRecords 将 设置为 13。

适用于

另请参阅