MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan kumpulan pengguna keanggotaan di mana nama pengguna berisi nama pengguna yang ditentukan untuk dicocokkan.
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
Parameter
- usernameToMatch
- String
Nama pengguna yang akan dicari.
- pageIndex
- Int32
Indeks halaman hasil yang akan dikembalikan.
pageIndex
berbasis nol.
- pageSize
- Int32
Ukuran halaman hasil yang akan dikembalikan.
- totalRecords
- Int32
Jumlah total pengguna yang cocok.
Mengembalikan
Koleksi MembershipUserCollection yang berisi halaman pageSize
MembershipUser objek yang dimulai pada halaman yang ditentukan oleh pageIndex
.
Contoh
Untuk contoh MembershipProvider implementasi, lihat Menerapkan Penyedia Profil.
Keterangan
FindUsersByName mengembalikan daftar pengguna keanggotaan di mana nama pengguna cocok dengan yang disediakan usernameToMatch
untuk properti yang dikonfigurasi ApplicationName . Jika sumber data Anda mendukung kemampuan pencarian tambahan, seperti karakter kartubebas, Anda dapat memberikan kemampuan pencarian yang lebih luas untuk nama pengguna.
Hasil yang dikembalikan oleh FindUsersByName dibatasi oleh pageIndex
parameter dan pageSize
. Parameter pageSize
mengidentifikasi jumlah MembershipUser objek yang akan dikembalikan dalam MembershipUserCollection koleksi. Parameter pageIndex
mengidentifikasi halaman hasil mana yang akan dikembalikan, di mana 0 mengidentifikasi halaman pertama. Parameter totalRecords
adalah out
parameter yang diatur ke jumlah total pengguna keanggotaan yang cocok dengan usernameToMatch
nilai. Misalnya, jika 13 pengguna ditemukan di mana usernameToMatch
bagian yang cocok dari atau seluruh nama pengguna, dan pageIndex
nilainya adalah 1 dengan pageSize
5, maka MembershipUserCollection akan berisi yang keenam hingga pengguna kesepuluh yang dikembalikan.
totalRecords
akan diatur ke 13.