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.MembershipUserCollectionPublic MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParameter
- usernameToMatch
- String
Nama pengguna yang akan dicari.
- pageIndex
- Int32
Indeks halaman hasil yang akan dikembalikan.
pageIndex adalah berbasis nol.
- pageSize
- Int32
Ukuran halaman hasil yang akan dikembalikan.
- totalRecords
- Int32
Jumlah total pengguna yang cocok.
Mengembalikan
Kumpulan MembershipUserCollection yang berisi halaman pageSizeMembershipUser 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 menyediakan 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.
