ProfileProvider.FindProfilesByUserName 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.
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Profilinformationen für Profile abgerufen, in denen der Benutzername den angegebenen Benutzernamen entspricht.
public:
abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName(System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollectionPublic MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollectionParameter
- authenticationOption
- ProfileAuthenticationOption
Einer der ProfileAuthenticationOption Werte, der angibt, ob anonym, authentifiziert oder beide Arten von Profilen zurückgegeben werden.
- usernameToMatch
- String
Der Benutzername, nach dem gesucht werden soll.
- pageIndex
- Int32
Der Index der zurückzugebenden Ergebnisseite.
- pageSize
- Int32
Die Größe der zurückzugebenden Ergebnisseite.
- totalRecords
- Int32
Wenn diese Methode zurückgegeben wird, enthält sie die Gesamtanzahl der Profile.
Gibt zurück
A ProfileInfoCollection containing user-profile information for profiles where the user name matches the supplied usernameToMatch parameter.
Beispiele
Das folgende Codebeispiel zeigt die Methodensignatur für eine Implementierung der FindProfilesByUserName Methode. Ein Beispiel für eine vollständige ProfileProvider Implementierung finden Sie unter How to: Build and Run the Profile Provider Example.
public override ProfileInfoCollection FindProfilesByUserName(
ProfileAuthenticationOption authenticationOption,
string usernameToMatch,
int pageIndex,
int pageSize,
out int totalRecords)
{
totalRecords = 0;
return new ProfileInfoCollection();
}
Public Overrides Function FindProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
ByRef totalRecords As Integer) As ProfileInfoCollection
totalRecords = 0
Return New ProfileInfoCollection()
End Function
Hinweise
Die FindProfilesByUserName Methode gibt eine Liste der Profilinformationen für Profile zurück, in denen der Benutzername mit dem angegebenen usernameToMatch Parameter übereinstimmt. Es werden nur Daten für die applicationName in der Konfigurationsdatei angegebene Zurückgegeben. Der authenticationOption Parameter gibt an, ob nur anonyme Profile, nur authentifizierte Profile oder alle Profile durchsucht werden.
Wenn Ihre Datenquelle zusätzliche Suchfunktionen wie z. B. Wildcardzeichen unterstützt, können Sie umfangreichere Suchfunktionen für Benutzernamen bereitstellen.
Die zurückgegebenen FindProfilesByUserName Ergebnisse werden von den Parametern und pageIndex den pageSize Parametern eingeschränkt. Der pageSize Parameter gibt die maximale Anzahl von ProfileInfo Objekten an, die in der ProfileInfoCollection. Der pageIndex Parameter gibt an, welche Ergebnisseite zurückgegeben werden soll, wobei null die erste Seite identifiziert. Der totalRecords Parameter ist ein out Parameter, der auf die Gesamtanzahl der inaktiven Benutzerprofile für die konfigurierten applicationNameBenutzer basierend auf den authenticationOption Parametern und userInactiveSinceDate Parametern festgelegt ist. Wenn z. B. 13 Benutzer für die Konfiguration vorhanden applicationNamesind und der pageIndex Wert 1 mit pageSize 5 ist, würde der ProfileInfoCollection zurückgegebene Wert den sechsten bis zehnten inaktiven Profile enthalten, der zurückgegeben wird. Der totalRecords Parameter wäre auf 13 festgelegt.
