MembershipProvider.FindUsersByEmail(String, Int32, Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Auflistung von Mitgliedschaftsbenutzern ab, bei denen die E-Mail-Adresse die zu vergleichende angegebene E-Mail-Adresse enthält.
public:
abstract System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public abstract System.Web.Security.MembershipUserCollection FindUsersByEmail(string emailToMatch, int pageIndex, int pageSize, out int totalRecords);abstract member FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollectionPublic MustOverride Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParameter
- emailToMatch
- String
Die gesuchte E-Mail-Adresse.
- pageIndex
- Int32
Der Index der zurückzugebenden Ergebnisseite.
pageIndex ist nullbasiert.
- pageSize
- Int32
Die Größe der zurückzugebenden Ergebnisseite.
- totalRecords
- Int32
Die Gesamtanzahl übereinstimmender Benutzer.
Gibt zurück
Eine MembershipUserCollection-Auflistung, die eine Seite mit pageSizeMembershipUser-Objekten beginnend mit der von pageIndex angegebenen Seite enthält.
Beispiele
Ein Beispiel für eine MembershipProvider Implementierung finden Sie unter Implementieren eines Profilanbieters.
Hinweise
FindUsersByEmailgibt eine Liste von Mitgliedschaftsbenutzern zurück, bei denen die E-Mail-Adresse des Benutzers mit der für die konfigurierte ApplicationName Eigenschaft angegebenen emailToMatch übereinstimmt. Wenn Ihre Datenquelle zusätzliche Suchfunktionen wie Wildcardzeichen unterstützt, können Sie umfangreichere Suchfunktionen für E-Mail-Adressen bereitstellen.
Die von FindUsersByEmail zurückgegebenen Ergebnisse werden durch die pageIndex Parameter und pageSize eingeschränkt. Der pageSize -Parameter gibt die Anzahl von MembershipUser Objekten an, die in der MembershipUserCollection Auflistung zurückgegeben werden sollen. Der pageIndex Parameter gibt an, welche Ergebnisseite zurückgegeben werden soll, wobei 0 die erste Seite identifiziert. Der totalRecords Parameter ist ein out Parameter, der auf die Gesamtzahl der Mitgliedschaftsbenutzer festgelegt ist, die mit dem emailToMatch Wert übereinstimmen. Wenn beispielsweise 13 Benutzer gefunden wurden, bei denen emailToMatch ein Teil oder die gesamte E-Mail-Adresse übereinstimmt, und der pageIndex Wert 1 mit einem pageSize von 5 war, dann würde der MembershipUserCollection sechste bis zehnte zurückgegebene Benutzer enthalten.
totalRecords wird auf 13 festgelegt.
