Udostępnij przez

ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Security
Zestaw:
System.Web.dll

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 -> string
Public Overrides Function GetUserNameByEmail (email As String) As String

Parametry

email
String

Adres e-mail do wyszukania.

Zwraca

String

Nazwa użytkownika skojarzona z określonym adresem e-mail.

Wyjątki

ArgumentException

email przekracza 256 znaków

-lub-

po przycinaniu email wartość jest pusta.

ProviderException

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.

InvalidOperationException

Dostawca nie jest inicjowany.

Uwagi

Ta metoda jest wywoływana przez klasę Membership 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żna ustawić requiresUniqueEmail atrybut elementu członkostwa (ASP.NET Ustawienia Schemat) 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 element . 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 mają negatywnego wpływu na wydajność serwera katalogu.

Ważne

Metoda zostanie uruchomiona GetUserNameByEmail nawet wtedy, gdy EnableSearchMethods właściwość ma falsewartość .

ActiveDirectoryMembershipProvider Ponieważ klasa jest przeznaczona dla bezstanowego środowiska internetowego, nie może używać 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 ich 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.

Dotyczy

Zobacz też