MembershipProvider.FindUsersByEmail(String, Int32, Int32, Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá kolekci uživatelů členství, kde e-mailová adresa obsahuje zadanou e-mailovou adresu, která se má shodovat.
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
Parametry
- emailToMatch
- String
E-mailová adresa, kterou chcete vyhledat.
- pageIndex
- Int32
Index stránky výsledků, která se má vrátit.
pageIndex je založen na nule.
- pageSize
- Int32
Velikost stránky výsledků, která se má vrátit.
- totalRecords
- Int32
Celkový počet odpovídajících uživatelů.
Návraty
MembershipUserCollection Kolekce, která obsahuje stránku pageSizeMembershipUser objektů začínající na stránce určené .pageIndex
Příklady
Příklad MembershipProvider implementace naleznete v tématu Implementace zprostředkovatele profilu.
Poznámky
FindUsersByEmail vrátí seznam uživatelů členství, u kterých e-mailová adresa uživatele odpovídá zadané emailToMatch pro konfigurovanou ApplicationName vlastnost. Pokud váš zdroj dat podporuje další možnosti vyhledávání, jako jsou zástupné znaky, můžete pro e-mailové adresy poskytnout rozsáhlejší možnosti hledání.
Výsledky vrácené jsou FindUsersByEmail omezené parametry pageIndex a pageSize parametry. Parametr pageSize identifikuje počet MembershipUser objektů, které se mají v kolekci MembershipUserCollection vrátit. Parametr pageIndex určuje, která stránka výsledků se má vrátit, kde 0 identifikuje první stránku. Parametr totalRecords je out parametr, který je nastavený na celkový počet uživatelů členství, kteří odpovídali hodnotě emailToMatch . Pokud bylo například nalezeno 13 uživatelů, kteří emailToMatch se shodovali s částí celé e-mailové adresy nebo celou e-mailovou adresou, a pageIndex hodnota byla 1 s pageSize hodnotou 5, pak MembershipUserCollection by obsahovala šestou až desátou vrácenou hodnotu.
totalRecords by byla nastavena na hodnotu 13.