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
Общее число соответствующих пользователей.
Возвращаемое значение
Коллекция MembershipUserCollection, которая содержит страницу объектов pageSize
MembershipUser, начиная со страницы, указанной параметром pageIndex
.
Примеры
Пример реализации см. в MembershipProvider разделе Реализация поставщика профилей.
Комментарии
FindUsersByEmail возвращает список пользователей членства, адрес электронной почты которого соответствует emailToMatch
указанному для настроенного ApplicationName свойства. Если источник данных поддерживает дополнительные возможности поиска, такие как подстановочные знаки, вы можете предоставить более широкие возможности поиска для адресов электронной почты.
Результаты, возвращаемые параметром , FindUsersByEmail ограничены параметрами pageIndex
и pageSize
. Параметр pageSize
определяет количество объектов, возвращаемых MembershipUser в MembershipUserCollection коллекции. Параметр pageIndex
определяет, какая страница результатов возвращается, где 0 определяет первую страницу. Параметр totalRecords
является параметром out
, который имеет общее число пользователей членства, соответствующих значению emailToMatch
. Например, если найдено 13 пользователей, где emailToMatch
совпадает часть или весь адрес электронной почты, а pageIndex
значение равно 1 с значением pageSize
5, то MembershipUserCollection будет содержать от шестого до десятого возвращенных пользователей.
totalRecords
будет задано значение 13.