ActiveDirectoryMembershipProvider.FindUsersByName 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.
Retourneert een verzameling gebruikers uit het Active Directory gegevensarchief op basis van de gebruikersnaam.
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.MembershipUserCollectionPublic Overrides Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParameters
- usernameToMatch
- String
De gebruikersnaam of het gedeelte van een gebruikersnaam om naar te zoeken.
- 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 FindUsersByName(String, Int32, Int32, Int32) methode wordt aangeroepen voordat het ActiveDirectoryMembershipProvider exemplaar wordt geïnitialiseerd.
usernameToMatch is leeg of overschrijdt de maximale lengte voor de gebruikersnaam (meestal 256 tekens).
– of –
usernameToMatch bevat komma's.
– of –
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.
usernameToMatch is null.
De eigenschap EnableSearchMethods is false.
Opmerkingen
De methode FindUsersByName retourneert een MembershipUserCollection-exemplaar met de gebruikersrecords uit het Active Directory gegevensarchief voor alle gebruikersnamen die overeenkomen met de parameters userNameToMatch. De records worden alfabetisch gesorteerd op gebruikersnaam.
De resultaten die door de FindUsersByName 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. 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 een pageSize van 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-instellingenschema) element. Als u de EnableSearchMethods eigenschapswaarde instelt om ervoor te false zorgen dat de FindUsersByName 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.