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í je email prázdný.

ProviderException

V úložišti dat se stejnou e-mailovou RequiresUniqueEmail adresou existuje více než jeden uživatel 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 oříznou z hodnoty parametru email . Pokud je e-mailová adresa po oříznutí prázdná, ArgumentException vyvolá se příkaz . Pokud je nulle-mailová adresa , prohledají se všechna uživatelská jména v úložišti dat služby Active Directory a vrátí se jméno uživatele.

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 adresářového serveru.

Důležité

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

Vzhledem k tomu, že ActiveDirectoryMembershipProvider třída je navržena pro bezstavové webové prostředí, nemůže 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 je třeba se jim vyhnout. Operace vyhledávání se vždy vydávají na adresářový server nakonfigurovaný v připojovacím řetězci nebo na automaticky vybraný server v případě připojovacího řetězce směřují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í 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í