ActiveDirectoryMembershipProvider.GetUserNameByEmail(String) Metoda

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Získá uživatelské jméno přidružené k zadané e-mailové adrese.

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

E-mailová adresa, kterou chcete vyhledat.

Návraty

String

Uživatelské jméno přidružené k zadané e-mailové adrese.

Výjimky

ArgumentException

email více než 256 znaků

-nebo-

po oříznutí, email je prázdný.

ProviderException

V úložišti dat existuje více uživatelů se stejnou e-mailovou RequiresUniqueEmail adresou a hodnota vlastnosti je true.

InvalidOperationException

Zprostředkovatel není inicializován.

Poznámky

Tato metoda je volána Membership třídou k načtení uživatelského jména z úložiště dat služby Active Directory na základě e-mailové adresy uživatele.

Pokud má stejnou e-mailovou adresu více uživatelů v úložišti dat členství, vrátí se první zjištěné uživatelské jméno. V konfiguračním souboru aplikace můžete nastavit requiresUniqueEmail atribut elementu membership Element (ASP.NET Settings Schema) na true , abyste zajistili, že každá e-mailová adresa v databázi bude jedinečná.

Počáteční a koncové mezery se z hodnoty parametru email oříznou. Pokud je e-mailová adresa po oříznutí prázdná, ArgumentException vyvolá se příkaz . Pokud je nulle-mailová adresa , prohledá se všechna uživatelská jména v úložišti dat služby Active Directory a vrátí se první uživatelské jméno.

Doporučujeme nepovolovat vyhledávání v produkčních systémech, dokud nepotvrdíte, že vyhledávací dotazy vydané ActiveDirectoryMembershipProvider třídou nemají nepříznivý vliv na výkon vašeho adresářového serveru.

Důležité

Metoda GetUserNameByEmail se spustí, i když je falsevlastnost EnableSearchMethods .

Vzhledem k tomu, že ActiveDirectoryMembershipProvider je třída navržena pro bezstavové webové prostředí, není schopna použít optimalizace stránkování zveřejněné podkladovými System.DirectoryServices rozhraními API. To znamená, že operace stránkování během hledání ve velkých adresářích jsou velmi nákladné a měli byste se jim vyhnout. Operace hledání se vždy prosadí na adresářový server nakonfigurovaný v připojovacím řetězci, nebo na automaticky vybraný server v případě připojovacího řetězce odkazujícího na doménu. Zprostředkovatel nepoužívá globální katalog pro své metody vyhledávání.

Zprostředkovatel používá vyhledávání v podstromu počínaje vyhledávacím bodem zadaným v připojovacím řetězci. Další informace o připojovacích řetězcích najdete v ActiveDirectoryMembershipProvider tématu třídy.

Viz také

• Úvod do ASP.NET členství