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 mají vrátit.
pageIndex
je založen na nule.
- pageSize
- Int32
Velikost stránky výsledků, které se mají vrátit.
- totalRecords
- Int32
Celkový počet odpovídajících uživatelů.
Návraty
Kolekce MembershipUserCollection , která obsahuje stránku pageSize
MembershipUser objektů začínající na stránce určené nástrojem pageIndex
.
Příklady
Příklad MembershipProvider implementace najdete v tématu Implementace zprostředkovatele profilu.
Poznámky
FindUsersByEmail vrátí seznam uživatelů členství, kde e-mailová adresa uživatele odpovídá zadané emailToMatch
pro nakonfigurovanou ApplicationName vlastnost. Pokud váš zdroj dat podporuje další možnosti vyhledávání, například zástupné znaky, můžete pro e-mailové adresy poskytnout rozsáhlejší možnosti vyhledávání.
Výsledky vrácené nástrojem FindUsersByEmail jsou omezeny pageIndex
parametry a pageSize
. Parametr pageSize
identifikuje počet MembershipUser objektů, které se mají vrátit v kolekci MembershipUserCollection . Parametr pageIndex
určuje, která stránka výsledků se má vrátit, kde hodnota 0 identifikuje první stránku. Parametr totalRecords
je out
parametr, který je nastaven na celkový počet uživatelů členství, kteří odpovídají hodnotě emailToMatch
. Pokud se například najde 13 uživatelů, kteří emailToMatch
odpovídají části e-mailové adresy nebo celé e-mailové adrese, a pageIndex
hodnota byla 1 s pageSize
hodnotou 5, pak MembershipUserCollection bude obsahovat šestý až desátý vrácený uživatel.
totalRecords
by byla nastavena na hodnotu 13.