ActiveDirectoryMembershipProvider.FindUsersByEmail 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.
Mengembalikan kumpulan pengguna keanggotaan dari penyimpanan data Direktori Aktif berdasarkan alamat email pengguna.
public:
override System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public override System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch, int pageIndex, int pageSize, out int totalRecords);override this.FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollectionPublic Overrides Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParameter
- emailToMatch
- String
Alamat email atau bagian alamat email untuk dicari.
- pageIndex
- Int32
Indeks halaman hasil yang akan dikembalikan.
pageIndex berbasis nol.
- pageSize
- Int32
Ukuran halaman hasil yang akan dikembalikan.
- totalRecords
- Int32
Ketika metode ini kembali, berisi jumlah total pengguna yang dikembalikan dalam koleksi. Parameter ini diteruskan tanpa diinisialisasi.
Mengembalikan
Instans MembershipUserCollection yang berisi pageSizeMembershipUser dimulai di halaman yang ditentukan oleh pageIndex.
Pengecualian
Metode FindUsersByEmail(String, Int32, Int32, Int32) ini dipanggil sebelum instans diinisialisasi ActiveDirectoryMembershipProvider .
emailToMatch kosong.
-atau-
emailToMatch melebihi 256 karakter.
-atau-
pageIndex kurang dari 0.
-atau-
pageSize kurang dari 1.
-atau-
pageSize dikalikan dengan pageIndex, plus pageSize, minus 1 lebih besar dari Int32.MaxValue.
Properti EnableSearchMethods adalah false.
Keterangan
Metode FindUsersByEmail ini mendapatkan yang MembershipUserCollection berisi rekaman pengguna dari penyimpanan Direktori Aktif yang cocok dengan emailToMatch parameter. Catatan pengguna dikembalikan diurutkan dalam urutan naik menurut alamat email.
Parameter emailToMatch dibatasi hingga 256 karakter.
Kelas ActiveDirectoryMembershipProvider akan mengeluarkan pencarian menggunakan clientSearchTimeout nilai konfigurasi dan serverSearchTimeout .
ActiveDirectoryMembershipProvider Karena kelas melakukan pencarian terhadap server direktori menggunakan halaman dengan 512 baris per halaman, batas waktu berlaku untuk setiap halaman hasil yang diambil oleh ActiveDirectoryMembershipProvider kelas. Misalnya, jika kueri pencarian menghasilkan 1.000 baris data, ActiveDirectoryMembershipProvider kelas akan mengambil informasi ini sebagai dua halaman data. Ini berarti bahwa klien dan waktu habis pencarian akan mulai dihitung dari nol ketika ActiveDirectoryMembershipProvider kelas meminta halaman kedua data.
Hasil yang dikembalikan oleh FindUsersByEmail metode dibatasi oleh pageIndex parameter dan pageSize . Parameter pageSize menentukan jumlah MembershipUser maksimum instans yang akan dikembalikan di MembershipUserCollection. Parameter pageIndex menentukan halaman hasil mana yang akan dikembalikan, di mana 0 (nol) menunjukkan halaman pertama.
Parameter totalRecords adalah out parameter yang diatur ke jumlah total pengguna keanggotaan yang cocok yang ditemukan di penyimpanan data Direktori Aktif. Misalnya, jika ada 13 pengguna untuk penyimpanan data yang dikonfigurasi, dan nilainya pageIndex adalah 1 dengan pageSize 5, yang MembershipUserCollection dikembalikan akan berisi pengguna keenam hingga kesepuluh. Parameter totalRecords akan diatur ke 13.
Anda dapat mengontrol apakah akan mengizinkan pencarian pengguna, dengan mengatur EnableSearchMethods properti dalam file konfigurasi aplikasi menggunakan enableSearchMethods atribut elemen Element (ASP.NET Settings Schema) keanggotaan .
EnableSearchMethods Mengatur properti untuk false menyebabkan FindUsersByEmail metode melemparkan NotSupportedException pengecualian.
Penyedia menggunakan pencarian subtree mulai dari titik pencarian yang ditentukan dalam string koneksi. ActiveDirectoryMembershipProvider Lihat topik kelas untuk informasi selengkapnya tentang string koneksi.
Kami menyarankan agar Anda tidak mengaktifkan pencarian pada sistem produksi sampai Anda mengonfirmasi bahwa kueri pencarian yang dikeluarkan oleh ActiveDirectoryMembershipProvider kelas tidak berdampak buruk pada performa server direktori Anda. ActiveDirectoryMembershipProvider Karena kelas dirancang untuk lingkungan Web stateless, tidak dapat menggunakan pengoptimalan penomoran halaman yang diekspos oleh API yang mendasarSystem.DirectoryServices. Ini berarti bahwa operasi paging selama pencarian terhadap direktori besar sangat mahal dan harus dihindari. Operasi pencarian selalu dikeluarkan terhadap server direktori yang dikonfigurasi dalam string koneksi, atau server yang dipilih secara otomatis dalam kasus string koneksi yang menunjuk ke domain. Penyedia tidak menggunakan katalog global untuk metode pencariannya.
