ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Yöntem

Tanım

Ad Alanı:

System.Web.Security

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen e-posta adresiyle ilişkili kullanıcı adını alır.

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

Parametreler

email

String

Aranacak e-posta adresi.

Döndürülenler

String

Belirtilen e-posta adresiyle ilişkili kullanıcı adı.

Özel durumlar

ArgumentException

email 256 karakteri aşıyor

-veya-

kırpıldıktan email sonra boş olur.

ProviderException

Veri deposunda aynı e-posta adresine sahip birden fazla kullanıcı var ve RequiresUniqueEmail özellik değeri şeklindedir true.

InvalidOperationException

Sağlayıcı başlatılmadı.

Açıklamalar

Bu yöntem, kullanıcının e-posta adresine göre Active Directory veri deposundan bir kullanıcı adı almak için sınıfı tarafından Membership çağrılır.

Üyelik veri deposundaki birden fazla kullanıcı aynı e-posta adresine sahipse, karşılaşılan ilk kullanıcı adı döndürülür. Veritabanındaki requiresUniqueEmail her e-posta adresinin benzersiz olduğundan emin olmak için true uygulama yapılandırma dosyasında membership Öğesi (ASP.NET Ayarlar Şeması) öğesinin özniteliğini olarak ayarlayabilirsiniz.

Baştaki ve sondaki boşluklar parametre değerinden email kırpılır. Kırpma sonrasında e-posta adresi boşsa, bir ArgumentException oluşturulur. E-posta adresi ise null, Active Directory veri deposundaki tüm kullanıcı adları aranırsa ve ilk kullanıcı adı döndürülür.

Sınıf tarafından ActiveDirectoryMembershipProvider verilen arama sorgularının dizin sunucunuzun performansını olumsuz etkilemediğini onaylayana kadar üretim sistemlerinde aramayı etkinleştirmemenizi öneririz.

Önemli

GetUserNameByEmail özelliği falseolduğunda EnableSearchMethods bile yöntemi çalıştırılır.

ActiveDirectoryMembershipProvider sınıfı durum bilgisi olmayan bir Web ortamı için tasarlandığından, temel alınan System.DirectoryServices API'ler tarafından kullanıma sunulan disk belleği iyileştirmelerini kullanamaz. Bu, büyük dizinlere yönelik aramalar sırasındaki disk belleği işlemlerinin çok pahalı olduğu ve bundan kaçınılması gerektiği anlamına gelir. Arama işlemleri her zaman bağlantı dizesinde yapılandırılan dizin sunucusuna veya bir etki alanını işaret eden bir bağlantı dizesi söz konusu olduğunda otomatik olarak seçilen bir sunucuya verilir. Sağlayıcı, arama yöntemleri için genel katalog kullanmaz.

Sağlayıcı, bağlantı dizesinde belirtilen arama noktasından başlayarak bir alt ağaç araması kullanır. ActiveDirectoryMembershipProvider Bağlantı dizeleri hakkında daha fazla bilgi için sınıf konusuna bakın.

Ayrıca bkz.

• ASP.NET Üyeliğine Giriş