MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Metoda

Reference

Definice

Obor názvů:: System.Web.Security

Sestavení:: System.Web.dll

Sestavení:: System.Web.ApplicationServices.dll

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 uživatelské jméno obsahuje zadané uživatelské jméno, které se má shodovat.

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parametry

usernameToMatch: String

Uživatelské jméno, které 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

MembershipUserCollection

Kolekce MembershipUserCollection , která obsahuje stránku pageSizeMembershipUser 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

FindUsersByName vrátí seznam uživatelů členství, kde uživatelské jméno odpovídá zadanému usernameToMatch pro nakonfigurovanou ApplicationName vlastnost. Pokud zdroj dat podporuje další možnosti vyhledávání, například zástupné znaky, můžete pro uživatelská jména poskytnout rozsáhlejší možnosti vyhledávání.

Výsledky vrácené nástrojem FindUsersByName 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, kterou stránku 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ě usernameToMatch . Pokud se například najde 13 uživatelů, kteří usernameToMatch odpovídají části nebo celému uživatelskému jménu, 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.

Platí pro

Sdílet prostřednictvím