MembershipProvider.FindUsersByEmail(String, Int32, Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取成员资格用户集合,这些用户的电子邮件地址包含要匹配的指定电子邮件地址。
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
匹配用户的总数。
返回
包含一页 pageSize
MembershipUser 对象的 MembershipUserCollection 集合,这些对象从 pageIndex
指定的页开始。
示例
有关实现的示例 MembershipProvider ,请参阅 实现配置文件提供程序。
注解
FindUsersByEmail返回成员身份用户的列表,其中用户的电子邮件地址与为配置ApplicationName的属性提供的 emailToMatch
匹配。 如果数据源支持其他搜索功能(如通配符),则可以为电子邮件地址提供更广泛的搜索功能。
返回 FindUsersByEmail 的结果受 pageIndex
和 pageSize
参数的约束。 参数pageSize
标识集合中MembershipUserCollection要返回的对象数MembershipUser。 参数 pageIndex
标识要返回的结果页,其中 0 标识第一页。 参数 totalRecords
是一个 out
参数,它设置为与值匹配 emailToMatch
的成员身份用户总数。 例如,如果在匹配部分或整个电子邮件地址的位置 emailToMatch
找到 13 个用户,并且 pageIndex
值为 1,值为 pageSize
5,则 MembershipUserCollection 将包含返回的第六个到第十个用户。
totalRecords
将 设置为 13。