ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de gebruikersnaam op die is gekoppeld aan het opgegeven e-mailadres.
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 StringParameters
- String
Het e-mailadres waarnaar moet worden gezocht.
Retouren
De gebruikersnaam die is gekoppeld aan het opgegeven e-mailadres.
Uitzonderingen
Er bestaat meer dan één gebruiker in het gegevensarchief met hetzelfde e-mailadres en de RequiresUniqueEmail eigenschapswaarde is true.
De provider is niet geïnitialiseerd.
Opmerkingen
Deze methode wordt aangeroepen door de klasse Membership om een gebruikersnaam op te halen uit het Active Directory gegevensarchief op basis van het e-mailadres voor de gebruiker.
Als meer dan één gebruiker in het lidmaatschapsgegevensarchief hetzelfde e-mailadres heeft, wordt de voornaam geretourneerd. U kunt het kenmerk requiresUniqueEmail van het element lidship (ASP.NET Settings Schema) instellen op true in het toepassingsconfiguratiebestand om ervoor te zorgen dat elk e-mailadres in de database uniek is.
Voorloop- en volgspaties worden afgekapt van de email parameterwaarde. Als het e-mailadres leeg is na het bijsnijden, wordt er een ArgumentException gegenereerd. Als het e-mailadres is null, worden alle gebruikersnamen in het Active Directory gegevensarchief doorzocht en wordt de voornaam geretourneerd.
U wordt aangeraden geen zoekopdrachten in te schakelen op productiesystemen totdat u hebt bevestigd dat de zoekquery's die door de ActiveDirectoryMembershipProvider klasse zijn uitgegeven, geen negatieve invloed hebben op de prestaties van uw adreslijstserver.
Important
De GetUserNameByEmail methode wordt zelfs uitgevoerd wanneer de EnableSearchMethods eigenschap is false.
Omdat de ActiveDirectoryMembershipProvider klasse is ontworpen voor een staatloze webomgeving, kan deze de pagineringsoptimalisaties die worden weergegeven door de onderliggende System.DirectoryServices API's niet gebruiken. Dit betekent dat pagingbewerkingen tijdens zoekopdrachten in grote mappen erg duur zijn en moeten worden vermeden. Zoekbewerkingen worden altijd uitgevoerd op basis van de adreslijstserver die is geconfigureerd in de verbindingsreeks of een automatisch geselecteerde server in het geval van een verbindingsreeks die naar een domein wijst. De provider gebruikt geen globale catalogus voor de zoekmethoden.
De provider gebruikt een substructuurzoekopdracht die begint bij het zoekpunt dat is opgegeven in de verbindingsreeks. Zie het ActiveDirectoryMembershipProvider klasonderwerp voor meer informatie over verbindingsreeksen.
