ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 -> stringPublic Overrides Function GetUserNameByEmail (email As String) As StringParametreler
- String
Aranacak e-posta adresi.
Döndürülenler
Belirtilen e-posta adresiyle ilişkili kullanıcı adı.
Özel durumlar
Veri deposunda aynı e-posta adresine sahip birden fazla kullanıcı var ve RequiresUniqueEmail özellik değeri şeklindedir true.
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.
