ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Benutzernamen ab, der der angegebenen E-Mail-Adresse zugeordnet ist.
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 StringParameter
- String
Die gesuchte E-Mail-Adresse.
Gibt zurück
Der Benutzername, der der angegebenen E-Mail-Adresse zugeordnet ist.
Ausnahmen
email ist länger als 256 Zeichen.
- oder -
Nach dem Verkürzen ist email leer.
Im Datenspeicher sind mehrere Benutzer mit derselben E-Mail-Adresse vorhanden, und der RequiresUniqueEmail-Eigenschaftswert ist true.
Der Anbieter wird nicht initialisiert.
Hinweise
Diese Methode wird von der Membership Klasse aufgerufen, um einen Benutzernamen aus dem Active Directory-Datenspeicher basierend auf der E-Mail-Adresse für den Benutzer abzurufen.
Wenn mehr als ein Benutzer im Mitgliedschaftsdatenspeicher dieselbe E-Mail-Adresse aufweist, wird der Vorname zurückgegeben. Sie können das requiresUniqueEmail Attribut des Mitgliedschaftselements true (ASP.NET Einstellungen Schema) in der Anwendungskonfigurationsdatei festlegen, um sicherzustellen, dass jede E-Mail-Adresse in der Datenbank eindeutig ist.
Beim email-Parameterwert werden führende und nachstehende Leerzeichen abgeschnitten. Wenn die E-Mail-Adresse nach dem Kürzen leer ist, wird eine ArgumentException ausgelöst. Wenn die E-Mail-Adresse lautet null, werden alle Benutzernamen im Active Directory-Datenspeicher durchsucht, und der Vorname wird zurückgegeben.
Es wird empfohlen, die Suche nach Produktionssystemen nicht zu aktivieren, bis Sie bestätigt haben, dass die suchabfragen, die von der ActiveDirectoryMembershipProvider Klasse ausgestellt wurden, nicht negativ auf die Leistung Ihres Verzeichnisservers auswirken.
Wichtig
Die Methode wird auch ausgeführt, wenn die GetUserNameByEmail EnableSearchMethods Eigenschaft lautet false.
Da die ActiveDirectoryMembershipProvider Klasse für eine zustandslose Webumgebung konzipiert ist, kann die Seitenoptimierung nicht von den zugrunde System.DirectoryServices liegenden APIs verwendet werden. Dies bedeutet, dass Seitenvorgänge während der Suche nach großen Verzeichnissen sehr teuer sind und vermieden werden sollten. Suchvorgänge werden immer für den Verzeichnisserver ausgestellt, der in der Verbindungszeichenfolge konfiguriert ist, oder einen automatisch ausgewählten Server im Fall einer Verbindungszeichenfolge, die auf eine Domäne verweist. Der Anbieter verwendet keinen globalen Katalog für seine Suchmethoden.
Der Anbieter verwendet eine Unterstruktursuche ab dem suchpunkt, der in der Verbindungszeichenfolge angegeben ist. Weitere Informationen zu Verbindungszeichenfolgen finden Sie im ActiveDirectoryMembershipProvider Kursthema.