ActiveDirectoryMembershipProvider.FindUsersByEmail 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 lidmaatschapsgebruikers uit het Active Directory gegevensarchief op basis van het e-mailadres van de gebruiker.
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.MembershipUserCollectionPublic Overrides Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParameters
- emailToMatch
- String
E-mailadres of gedeelte van e-mailadres waarnaar u wilt 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 gebruikers dat in de verzameling is 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 FindUsersByEmail(String, Int32, Int32, Int32) methode wordt aangeroepen voordat het ActiveDirectoryMembershipProvider exemplaar wordt geïnitialiseerd.
emailToMatch is leeg.
– of –
emailToMatch overschrijdt 256 tekens.
– 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.
De eigenschap EnableSearchMethods is false.
Opmerkingen
De methode FindUsersByEmail haalt een MembershipUserCollection op met de gebruikersrecords uit het Active Directory archief die overeenkomen met de parameters emailToMatch. De gebruikersrecords worden gesorteerd in oplopende volgorde op e-mailadres.
De emailToMatch parameter is beperkt tot 256 tekens.
De ActiveDirectoryMembershipProvider klasse geeft de zoekopdracht uit met behulp van zowel de clientSearchTimeoutserverSearchTimeout als de configuratiewaarden. Omdat de ActiveDirectoryMembershipProvider klasse zoekopdrachten uitvoert op de adreslijstserver met behulp van pagina's met 512 rijen per pagina, zijn de time-outs van toepassing op elke pagina met resultaten die door de ActiveDirectoryMembershipProvider klasse zijn opgehaald. Als een zoekquery bijvoorbeeld resulteert in 1000 rijen met gegevens, haalt de ActiveDirectoryMembershipProvider klasse deze informatie op als twee pagina's met gegevens. Dit betekent dat de client- en zoektime-outs vanaf nul worden geteld wanneer de ActiveDirectoryMembershipProvider klasse de tweede pagina met gegevens aanvraagt.
De resultaten die door de FindUsersByEmail 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 eigenschap instelt om ervoor te false zorgen dat de FindUsersByEmail 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.
