ActiveDirectoryMembershipProvider.FindUsersByName Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí kolekci uživatelů z úložiště dat služby Active Directory na základě uživatelského jména.
public:
override System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public override System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
override this.FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public Overrides Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
Parametry
- usernameToMatch
- String
Uživatelské jméno nebo část uživatelského jména, které 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 záznamů vrácených v kolekci. Tento parametr se předává neinicializovaný.
Návraty
A MembershipUserCollection obsahující pageSize
MembershipUser instance začínající na stránce určené parametrem pageIndex
.
Výjimky
Metoda FindUsersByName(String, Int32, Int32, Int32) je volána před ActiveDirectoryMembershipProvider inicializaci instance.
usernameToMatch
je prázdné nebo překračuje maximální délku uživatelského jména (obvykle 256 znaků).
-nebo-
usernameToMatch
obsahuje čárky.
-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.
usernameToMatch
je null
.
Vlastnost EnableSearchMethods je false
.
Poznámky
Metoda FindUsersByName vrátí MembershipUserCollection instanci obsahující záznamy uživatele z úložiště dat služby Active Directory pro všechna uživatelská jména, která odpovídají parametrům userNameToMatch
. Záznamy se vrátí abecedně seřazené podle uživatelského jména.
Výsledky vrácené metodou FindUsersByName 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 enableSearchMethods
elementu membership Element (ASP.NET Schéma nastavení). EnableSearchMethods Nastavení hodnoty vlastnosti na způsobífalse
, že FindUsersByName 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í.
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro