ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera nazwę użytkownika skojarzona z określonym adresem e-mail.
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 StringParametry
- String
Adres e-mail do wyszukania.
Zwraca
Nazwa użytkownika skojarzona z określonym adresem e-mail.
Wyjątki
email przekracza 256 znaków
-lub-
po przycinaniu email jest puste.
W magazynie danych istnieje więcej niż jeden użytkownik o tym samym adresie e-mail, a RequiresUniqueEmail wartość właściwości to true.
Dostawca nie jest inicjowany.
Uwagi
Ta metoda jest wywoływana przez Membership klasę w celu pobrania nazwy użytkownika z magazynu danych usługi Active Directory na podstawie adresu e-mail użytkownika.
Jeśli więcej niż jeden użytkownik w magazynie danych członkostwa ma ten sam adres e-mail, zwracana jest pierwsza nazwa użytkownika. Możesz ustawić requiresUniqueEmail atrybut elementu członkostwa (ASP.NET Ustawienia Schema) na true w pliku konfiguracji aplikacji, aby upewnić się, że każdy adres e-mail w bazie danych jest unikatowy.
Spacje wiodące i końcowe są przycinane z wartości parametru email . Jeśli adres e-mail jest pusty po przycinaniu, ArgumentException zostanie zgłoszony. Jeśli adres e-mail to null, wszystkie nazwy użytkowników w magazynie danych usługi Active Directory są przeszukiwane i zwracana jest pierwsza nazwa użytkownika.
Zalecamy, aby nie włączać wyszukiwania w systemach produkcyjnych, dopóki nie potwierdzisz, że zapytania wyszukiwania wydane przez ActiveDirectoryMembershipProvider klasę nie wpływają negatywnie na wydajność serwera katalogów.
Ważne
Metoda zostanie uruchomiona GetUserNameByEmail nawet wtedy, gdy EnableSearchMethods właściwość to false.
ActiveDirectoryMembershipProvider Ponieważ klasa jest przeznaczona dla bezstanowego środowiska sieci Web, nie może korzystać z optymalizacji stronicowania uwidocznionych przez bazowe System.DirectoryServices interfejsy API. Oznacza to, że operacje stronicowania podczas wyszukiwania w dużych katalogach są bardzo kosztowne i należy unikać. Operacje wyszukiwania są zawsze wystawiane względem serwera katalogów skonfigurowanego w parametrach połączenia lub automatycznie wybranego serwera w przypadku parametrów połączenia wskazujących domenę. Dostawca nie używa wykazu globalnego dla swoich metod wyszukiwania.
Dostawca używa wyszukiwania poddrzewa rozpoczynającego się od punktu wyszukiwania określonego w parametrach połączenia. Zobacz temat klasy, ActiveDirectoryMembershipProvider aby uzyskać więcej informacji na temat parametrów połączenia.