ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Metode

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

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 -> string

Public Overrides Function GetUserNameByEmail (email As String) As String

Parameter

email

String

Alamat email yang akan dicari.

Mengembalikan

String

Nama pengguna yang terkait dengan alamat email yang ditentukan.

Pengecualian

ArgumentException

email melebihi 256 karakter

-atau-

setelah pemangkasan, email kosong.

ProviderException

Lebih dari satu pengguna ada di penyimpanan data dengan alamat email yang sama dan RequiresUniqueEmail nilai properti adalah true.

InvalidOperationException

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.

Lihat juga

• Pengantar Keanggotaan ASP.NET