ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Metod

Definition

Namnområde:
System.Web.Security
Sammansättning:
System.Web.dll

Hämtar användarnamnet som är associerat med den angivna e-postadressen.

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

Parametrar

email
String

E-postadressen som du vill söka efter.

Returer

String

Användarnamnet som är associerat med den angivna e-postadressen.

Undantag

ArgumentException

email överskrider 256 tecken

-eller-

efter trimning, email är tom.

ProviderException

Fler än en användare finns i datalagret med samma e-postadress och egenskapsvärdet RequiresUniqueEmail är true.

InvalidOperationException

Providern initieras inte.

Kommentarer

Den här metoden anropas av klassen Membership för att hämta ett användarnamn från služba Active Directory datalager baserat på användarens e-postadress.

Om fler än en användare i datalagret för medlemskap har samma e-postadress returneras det första användarnamnet som påträffades. Du kan ange attributet requiresUniqueEmail för elementet membership (ASP.NET Settings Schema) element till true i programkonfigurationsfilen för att säkerställa att varje e-postadress i databasen är unik.

Inledande och avslutande blanksteg trimmas från email parametervärdet. Om e-postadressen är tom efter trimning utlöses en ArgumentException . Om e-postadressen är null genomsöks alla användarnamn i služba Active Directory datalagret och det första användarnamnet returneras.

Vi rekommenderar att du inte aktiverar sökning på produktionssystem förrän du har bekräftat att sökfrågorna som utfärdats av ActiveDirectoryMembershipProvider klassen inte påverkar katalogserverns prestanda negativt.

Important

Metoden GetUserNameByEmail körs även när egenskapen EnableSearchMethods är false.

ActiveDirectoryMembershipProvider Eftersom klassen är utformad för en tillståndslös webbmiljö kan den inte använda växlingsoptimeringarna som exponeras av de underliggande System.DirectoryServices API:erna. Det innebär att växlingsåtgärder vid sökningar mot stora kataloger är mycket dyra och bör undvikas. Sökåtgärder utfärdas alltid mot katalogservern som konfigurerats i reťazec pripojenia, eller en automatiskt vald server om en reťazec pripojenia pekar på en domän. Providern använder inte en global katalog för sina sökmetoder.

Providern använder en underträdssökning som börjar vid sökpunkten som anges i reťazec pripojenia. Mer information om anslutningssträngar finns i ActiveDirectoryMembershipProvider klassavsnittet.

Gäller för

Se även