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

Referensi

Definisi

Ruang nama:: System.Web.Security

Rakitan:: System.Web.dll

Rakitan:: System.Web.ApplicationServices.dll

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

MembershipUserCollection

Koleksi 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 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.

Berlaku untuk

Bagikan melalui