ActiveDirectoryMembershipProvider.FindUsersByEmail Metoda

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Vrátí kolekci uživatelů členství z úložiště dat služby Active Directory na základě e-mailové adresy uživatele.

public:
 override System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public override System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch, int pageIndex, int pageSize, out int totalRecords);

override this.FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public Overrides Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parametry

emailToMatch

String

Email adresu nebo část e-mailové adresy, kterou chcete vyhledat.

pageIndex

Int32

Index stránky výsledků, které se mají vrátit. pageIndex je založen na nule.

pageSize

Int32

Velikost stránky výsledků, které se mají vrátit.

totalRecords

Int32

Když tato metoda vrátí, obsahuje celkový počet uživatelů vrácených v kolekci. Tento parametr se předává neinicializovaný.

Návraty

MembershipUserCollection

A MembershipUserCollection obsahující pageSizeMembershipUser instance začínající na stránce určené parametrem pageIndex.

Výjimky

InvalidOperationException

Metoda FindUsersByEmail(String, Int32, Int32, Int32) je volána před ActiveDirectoryMembershipProvider inicializaci instance.

ArgumentException

emailToMatch je prázdné.

-nebo-

emailToMatch delší než 256 znaků.

-nebo-

pageIndex je menší než 0.

-nebo-

pageSize je menší než 1.

-nebo-

pageSize Vynásobeno pageIndex, plus pageSize, minus 1 je větší než Int32.MaxValue.

NotSupportedException

Vlastnost EnableSearchMethods je false.

Poznámky

Metoda FindUsersByEmail získá MembershipUserCollection obsahující záznamy uživatele z úložiště služby Active Directory, které odpovídají parametrům emailToMatch . Záznamy uživatelů se vrátí vzestupně seřazené podle e-mailové adresy.

Parametr emailToMatch je omezen na 256 znaků.

Třída ActiveDirectoryMembershipProvider provede hledání pomocí konfiguračních clientSearchTimeout hodnot a serverSearchTimeout . Vzhledem k tomu, že ActiveDirectoryMembershipProvider třída provádí vyhledávání na adresářovém serveru pomocí stránek s 512 řádky na stránku, časové limity platí pro každou stránku výsledků načtených ActiveDirectoryMembershipProvider třídou. Například pokud vyhledávací dotaz má za následek 1 000 řádků dat, ActiveDirectoryMembershipProvider třída načte tyto informace jako dvě stránky dat. To znamená, že když třída požádá o druhou stránku dat, začnou se časové limity klienta a vyhledávání počítat od nuly ActiveDirectoryMembershipProvider .

Výsledky vrácené metodou FindUsersByEmail jsou omezeny pageIndex parametry a pageSize . Parametr pageSize určuje maximální počet instancí, které MembershipUser se mají vrátit v objektu MembershipUserCollection. Parametr pageIndex určuje, která stránka výsledků se má vrátit, kde 0 (nula) označuje první stránku.

Parametr totalRecords je parametr out nastavený na celkový počet odpovídajících uživatelů členství nalezených v úložišti dat služby Active Directory. Pokud je například pro nakonfigurované úložiště dat 13 uživatelů a pageIndex hodnota byla 1 s pageSize hodnotou 5, MembershipUserCollection vrácená hodnota by obsahovala šestého až desátého uživatele. Parametr totalRecords by byl nastaven na hodnotu 13.

Můžete určit, zda povolit vyhledávání uživatelů nastavením EnableSearchMethods vlastnosti v konfiguračním souboru aplikace pomocí atributu enableSearchMethodselementu membership Element (ASP.NET Schéma nastavení). EnableSearchMethods Nastavení vlastnosti na způsobífalse, že FindUsersByEmail metoda vyvolá NotSupportedException výjimku.

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.

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. 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í.

Viz také

• Úvod do ASP.NET členství