MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Methode

Referenz

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.dll

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

MembershipUserCollection

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

FindUsersByNamegibt eine Liste von Mitgliedschaftsbenutzern zurück, bei denen der Benutzername mit dem für die konfigurierte ApplicationName Eigenschaft angegebenen usernameToMatch übereinstimmt. Wenn Ihre Datenquelle zusätzliche Suchfunktionen unterstützt, z. B. Wildcardzeichen, können Sie umfangreichere Suchfunktionen für Benutzernamen bereitstellen.

Die von FindUsersByName 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 usernameToMatch Wert übereinstimmen. Wenn z. B. 13 Benutzer gefunden wurden, bei denen usernameToMatch ein Teil oder der gesamte Benutzername übereinstimmt, und der pageIndex Wert 1 mit einem pageSize von 5 ist, enthält den MembershipUserCollection sechsten bis zum zehnten zurückgegebenen Benutzer. totalRecords wird auf 13 festgelegt.

Gilt für:

Freigeben über