MembershipProvider.FindUsersByName(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, deren Benutzername den angegebenen Vergleichsbenutzernamen enthält.
public:
abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
Parameter
- usernameToMatch
- String
Der zu suchende Benutzername.
- 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 pageSize
MembershipUser-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
FindUsersByName gibt eine Liste von Mitgliedschaftsbenutzern zurück, bei denen der Benutzername mit der angegebenen usernameToMatch
für die konfigurierte Eigenschaft ApplicationName entspricht. Wenn Ihre Datenquelle zusätzliche Suchfunktionen wie Platzhalterzeichen unterstützt, können Sie umfangreichere Suchfunktionen für Benutzernamen bereitstellen.
Die von zurückgegebenen FindUsersByName Ergebnisse werden durch die Parameter und pageIndex
pageSize
eingeschränkt. Der pageSize
-Parameter gibt die Anzahl der Objekte MembershipUser an, die in der Auflistung zurückgibt. MembershipUserCollection Der pageIndex
-Parameter gibt an, welche Ergebnisseite zurückgibt, wobei 0 die erste Seite identifiziert. Der -Parameter ist ein Parameter, der auf die Gesamtzahl der Mitgliedschaftsbenutzer festgelegt totalRecords
out
wird, die mit dem Wert usernameToMatch
übereinstimmen. Wenn z. B. 13 Benutzer gefunden wurden, bei denen ein usernameToMatch
Teil von oder der gesamte Benutzername übereinstimmte, und der Wert pageIndex
1 mit einem von pageSize
5 war, MembershipUserCollection würde den sechsten bis zehnten zurückgegebenen Benutzer enthalten. totalRecords
wird auf 13 festgelegt.