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

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Security

Zestaw:: System.Web.dll

Zestaw:: System.Web.ApplicationServices.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Udostępnij za pośrednictwem