ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een verzameling op van alle gebruikers die zijn opgeslagen in een Active Directory gegevensbron.
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 MembershipUserCollectionParameters
- pageIndex
- Int32
De index van de pagina met resultaten die moeten worden geretourneerd.
pageIndex is gebaseerd op nul.
- pageSize
- Int32
De grootte van de pagina met resultaten die moeten worden geretourneerd.
- totalRecords
- Int32
Wanneer deze methode wordt geretourneerd, bevat het totale aantal records dat in de verzameling wordt geretourneerd. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
Retouren
Een MembershipUserCollection met pageSizeMembershipUser exemplaren die beginnen op de pagina die is opgegeven door pageIndex.
Uitzonderingen
De GetAllUsers(Int32, Int32, Int32) methode wordt aangeroepen voordat het ActiveDirectoryMembershipProvider exemplaar wordt geïnitialiseerd.
pageIndex is kleiner dan 0.
-of
pageSize is kleiner dan 1.
– of –
pageSize vermenigvuldigd met pageIndex, plus pageSize, min 1 is groter dan Int32.MaxValue.
De eigenschap EnableSearchMethods is false.
Opmerkingen
Deze methode wordt aangeroepen door de klasse Membership om gebruikersgegevens op te halen uit het Active Directory gegevensarchief dat is opgegeven in het configuratiebestand van de ASP.NET toepassing.
De resultaten die door de GetAllUsers methode worden geretourneerd, worden beperkt door de pageIndex en pageSize parameters. De pageSize parameter geeft het maximum aantal MembershipUser exemplaren op dat moet worden geretourneerd in de MembershipUserCollection verzameling. De pageIndex parameter geeft aan welke pagina met resultaten moet worden geretourneerd, waarbij 0 (nul) de eerste pagina aangeeft.
De parameter totalRecords is een parameter out die is ingesteld op het totale aantal overeenkomende lidmaatschapsgebruikers in het Active Directory gegevensarchief. Als er bijvoorbeeld 13 gebruikers zijn voor het geconfigureerde gegevensarchief en de pageIndex waarde 1 is met la pageSize 5, bevat de MembershipUserCollection geretourneerde waarde de zesde tot en met de tiende gebruikers. De totalRecords parameter wordt ingesteld op 13.
U kunt bepalen of u gebruikers wilt zoeken door de eigenschap EnableSearchMethods in het configuratiebestand van de toepassing in te stellen met behulp van het kenmerk enableSearchMethods van het element lidship (ASP.NET Schema instellingen) element. Als u de EnableSearchMethods eigenschap instelt om ervoor te false zorgen dat de GetAllUsers methode een NotSupportedException uitzondering genereert.
De provider gebruikt een substructuurzoekopdracht die begint bij het zoekpunt dat is opgegeven in de verbindingsreeks. Zie het ActiveDirectoryMembershipProvider klasonderwerp voor meer informatie over verbindingsreeksen.
U wordt aangeraden geen zoekopdrachten in te schakelen op productiesystemen totdat u hebt bevestigd dat de zoekquery's die door de ActiveDirectoryMembershipProvider klasse zijn uitgegeven, geen negatieve invloed hebben op de prestaties van uw adreslijstserver. Omdat de ActiveDirectoryMembershipProvider klasse is ontworpen voor een staatloze webomgeving, kan deze de pagineringsoptimalisaties die worden weergegeven door de onderliggende System.DirectoryServices API's niet gebruiken. Dit betekent dat pagingbewerkingen tijdens zoekopdrachten in grote mappen erg duur zijn en moeten worden vermeden. Zoekbewerkingen worden altijd uitgevoerd op basis van de adreslijstserver die is geconfigureerd in de verbindingsreeks of een automatisch geselecteerde server in het geval van een verbindingsreeks die naar een domein wijst. De provider gebruikt geen globale catalogus voor de zoekmethoden.
