ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) 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í.
Získá kolekci všech uživatelů uložených ve zdroji dat služby Active Directory.
public:
override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public override System.Web.Security.MembershipUserCollection GetAllUsers(int pageIndex, int pageSize, out int totalRecords);override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollectionPublic Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParametry
- pageIndex
- Int32
Index stránky výsledků, která se má vrátit.
pageIndex je založen na nule.
- pageSize
- Int32
Velikost stránky výsledků, která se má vrátit.
- totalRecords
- Int32
Pokud 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í pageSizeMembershipUser instance začínající na stránce určené pomocí pageIndex.
Výjimky
Metoda GetAllUsers(Int32, Int32, Int32) je volána před ActiveDirectoryMembershipProvider inicializace instance.
pageIndex je menší než 0.
-nebo
pageSize je menší než 1.
nebo
pageSize vynásobeno hodnotou pageIndex, plus , minus pageSize1 je větší než Int32.MaxValue.
Vlastnost EnableSearchMethods je false.
Poznámky
Tato metoda je volána Membership třídou k načtení informací o uživateli z úložiště dat služby Active Directory zadaného v konfiguračním souboru aplikace ASP.NET.
Výsledky vrácené metodou GetAllUsers jsou omezené parametry pageIndex a pageSize parametry. Parametr pageSize určuje maximální počet MembershipUser instancí, které se mají v kolekci MembershipUserCollection vrátit. Parametr pageIndex určuje, která stránka výsledků se má vrátit, kde 0 (nula) označuje první stránku.
Parametr totalRecords je out parametr nastavený na celkový počet odpovídajících uživatelů členství nalezených v úložišti dat služby Active Directory. Pokud například pro nakonfigurované úložiště dat existuje 13 uživatelů a pageIndex hodnota byla 1 s la pageSize z 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í enableSearchMethods atributu elementu členství (ASP.NET Settings Schema).
EnableSearchMethods Nastavením vlastnosti způsobíte, GetAllUsers že false metoda vyvolá NotSupportedException výjimku.
Zprostředkovatel používá vyhledávání podstromů 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 adresářového serveru. Vzhledem k tomu, že ActiveDirectoryMembershipProvider třída je navržena pro bezstavové webové prostředí, nemůže použít optimalizace stránkování vystavené podkladovými System.DirectoryServices rozhraními API. To znamená, že operace stránkování během hledání velkých adresářů jsou velmi drahé a měly by se jim vyhnout. Vyhledávací operace se vždy vydávají proti adresářovému serveru nakonfigurovaného v připojovacím řetězci nebo automaticky vybranému serveru v případě připojovacího řetězce odkazujícího na doménu. Poskytovatel nepoužívá globální katalog pro své vyhledávací metody.
