ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) 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 nama pengguna yang terkait dengan alamat email yang ditentukan.
public:
override System::String ^ GetUserNameByEmail(System::String ^ email);public override string GetUserNameByEmail (string email);override this.GetUserNameByEmail : string -> stringPublic Overrides Function GetUserNameByEmail (email As String) As StringParameter
- String
Alamat email yang akan dicari.
Mengembalikan
Nama pengguna yang terkait dengan alamat email yang ditentukan.
Pengecualian
Lebih dari satu pengguna ada di penyimpanan data dengan alamat email yang sama dan RequiresUniqueEmail nilai properti adalah true.
Penyedia tidak diinisialisasi.
Keterangan
Metode ini dipanggil oleh Membership kelas untuk mengambil nama pengguna dari penyimpanan data Direktori Aktif berdasarkan alamat email untuk pengguna.
Jika lebih dari satu pengguna di penyimpanan data keanggotaan memiliki alamat email yang sama, nama pengguna pertama yang ditemui akan dikembalikan. Anda dapat mengatur requiresUniqueEmail atribut elemen Element (ASP.NET Settings Schema) keanggotaan ke true dalam file konfigurasi aplikasi untuk memastikan bahwa setiap alamat email dalam database unik.
Spasi di depan email dan di belakang dipangkas dari nilai parameter. Jika alamat email kosong setelah pemangkasan, alamat ArgumentException akan dilemparkan. Jika alamat email adalah null, semua nama pengguna di penyimpanan data Direktori Aktif dicari, dan nama pengguna pertama dikembalikan.
Kami menyarankan agar Anda tidak mengaktifkan pencarian pada sistem produksi hingga Anda mengonfirmasi bahwa kueri pencarian yang dikeluarkan oleh ActiveDirectoryMembershipProvider kelas tidak berdampak buruk pada performa server direktori Anda.
Penting
Metode GetUserNameByEmail ini akan berjalan bahkan ketika EnableSearchMethods properti adalah false.
ActiveDirectoryMembershipProvider Karena kelas dirancang untuk lingkungan Web stateless, tidak dapat menggunakan pengoptimalan halaman yang diekspos oleh API yang mendasarSystem.DirectoryServices. Ini berarti bahwa operasi halaman 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.
Penyedia menggunakan pencarian subtree yang dimulai pada titik pencarian yang ditentukan dalam string koneksi. ActiveDirectoryMembershipProvider Lihat topik kelas untuk informasi selengkapnya tentang string koneksi.
