Udostępnij przez

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

Definicja

Przestrzeń nazw:
System.Web.Security
Zestaw:
System.Web.dll
Zestaw:
System.Web.ApplicationServices.dll

Pobiera kolekcję użytkowników członkostwa, w których nazwa użytkownika zawiera określoną nazwę użytkownika, która ma być zgodna.

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

Nazwa użytkownika do wyszukania.

pageIndex
Int32

Indeks strony wyników do zwrócenia. Funkcja pageIndex rozpoczyna liczenie od zera.

pageSize
Int32

Rozmiar strony wyników do zwrócenia.

totalRecords
Int32

Łączna liczba dopasowanych użytkowników.

Zwraca

MembershipUserCollection

MembershipUserCollection Kolekcja zawierająca stronę pageSizeMembershipUser obiektów rozpoczynającą się od strony określonej przez pageIndex.

Przykłady

Aby zapoznać się z przykładem implementacji MembershipProvider , zobacz Implementowanie dostawcy profilu.

Uwagi

FindUsersByName Zwraca listę użytkowników członkostwa, w których nazwa użytkownika jest zgodna z podaną usernameToMatch dla skonfigurowanej ApplicationName właściwości. Jeśli źródło danych obsługuje dodatkowe możliwości wyszukiwania, takie jak symbole wieloznaczne, możesz zapewnić bardziej rozbudowane możliwości wyszukiwania nazw użytkowników.

Wyniki zwracane przez FindUsersByName element są ograniczone przez pageIndex parametry i pageSize . Parametr pageSize określa liczbę MembershipUser obiektów, które mają być zwracane w kolekcji MembershipUserCollection . Parametr pageIndex określa, która strona wyników ma być zwracana, gdzie 0 identyfikuje pierwszą stronę. Parametr totalRecords jest parametrem out , który jest ustawiony na łączną liczbę użytkowników członkostwa pasujących do usernameToMatch wartości. Jeśli na przykład 13 użytkowników zostało znalezionych, gdzie usernameToMatch pasuje do części lub całej nazwy użytkownika, a pageIndex wartość to 1 z wartością pageSize 5, MembershipUserCollection wartość będzie zawierać szóstą do dziesiątej zwróconej liczby użytkowników. totalRecords wartość parametru zostanie ustawiona na wartość 13.

Dotyczy

Zobacz też