ActiveDirectoryMembershipProvider.FindUsersByEmail Metod

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.MembershipUserCollection

Public Overrides Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parametrar

Returer

En MembershipUserCollection innehållande pageSizeMembershipUser instanser som börjar på sidan som anges av pageIndex.

Undantag

Kommentarer

Metoden FindUsersByEmail hämtar en MembershipUserCollection som innehåller användarposterna från služba Active Directory-arkivet som matchar parametrarna emailToMatch. Användarposterna returneras sorterade i stigande ordning efter e-postadress.

Parametern emailToMatch är begränsad till 256 tecken.

Klassen ActiveDirectoryMembershipProvider utfärdar sökningen med både konfigurationsvärdena clientSearchTimeout och serverSearchTimeout . ActiveDirectoryMembershipProvider Eftersom klassen utför sökningar mot katalogservern med sidor med 512 rader per sida gäller tidsgränserna för varje sida med resultat som hämtas av ActiveDirectoryMembershipProvider klassen. Om en sökfråga till exempel resulterar i 1 000 datarader hämtar klassen den ActiveDirectoryMembershipProvider här informationen som två datasidor. Det innebär att tidsgränserna för klienten och sökningen börjar räknas från noll när ActiveDirectoryMembershipProvider klassen begär den andra sidan med data.

Resultaten som returneras av FindUsersByEmail metoden begränsas av parametrarna pageIndex och pageSize . Parametern pageSize anger det maximala antalet MembershipUser instanser som ska returneras i MembershipUserCollection. Parametern pageIndex anger vilken sida med resultat som ska returneras, där 0 (noll) anger den första sidan.

Parametern totalRecords är en parameter out som är inställd på det totala antalet matchande medlemskapsanvändare som finns i služba Active Directory datalagret. Om det till exempel finns 13 användare för det konfigurerade datalagret och pageIndex värdet var 1 med värdet pageSize 5, skulle den MembershipUserCollection returnerade innehålla den sjätte genom de tionde användarna. Parametern totalRecords skulle vara inställd på 13.

Du kan styra om du vill tillåta sökning efter användare genom att ange egenskapen EnableSearchMethods i programmets konfigurationsfil med attributet enableSearchMethods för elementet membership (ASP.NET Settings Schema) element. Om du ställer in egenskapen EnableSearchMethods på utlöser false metoden ett FindUsersByEmailNotSupportedException undantag.

Providern använder en underträdssökning som börjar vid sökpunkten som anges i reťazec pripojenia. Mer information om anslutningssträngar finns i ActiveDirectoryMembershipProvider klassavsnittet.

Vi rekommenderar att du inte aktiverar sökning på produktionssystem förrän du har bekräftat att sökfrågorna som utfärdats av ActiveDirectoryMembershipProvider klassen inte påverkar katalogserverns prestanda negativt. ActiveDirectoryMembershipProvider Eftersom klassen är utformad för en tillståndslös webbmiljö kan den inte använda växlingsoptimeringarna som exponeras av de underliggande System.DirectoryServices API:erna. Det innebär att växlingsåtgärder vid sökningar mot stora kataloger är mycket dyra och bör undvikas. Sökåtgärder utfärdas alltid mot katalogservern som konfigurerats i reťazec pripojenia, eller en automatiskt vald server om en reťazec pripojenia pekar på en domän. Providern använder inte en global katalog för sina sökmetoder.

Se även

• Introduction to ASP.NET Membership