ProfileProvider.FindInactiveProfilesByUserName Methode

Definition

Namespace:
System.Web.Profile
Assembly:
System.Web.dll

Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Profilinformationen für Profile abgerufen, in denen das letzte Aktivitätsdatum am oder vor dem angegebenen Datum aufgetreten ist und der Benutzername mit dem angegebenen Benutzernamen übereinstimmt.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindInactiveProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Profile.ProfileInfoCollection FindInactiveProfilesByUserName(System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);
abstract member FindInactiveProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public MustOverride Function FindInactiveProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

Parameter

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.

userInactiveSinceDate
DateTime

Ein DateTime Objekt, das identifiziert, welche Benutzerprofile als inaktiv betrachtet werden. Wenn der LastActivityDate Wert eines Benutzerprofils an oder vor diesem Datum und dieser Uhrzeit auftritt, wird das Profil als inaktiv betrachtet.

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

ProfileInfoCollection

Eine ProfileInfoCollection enthaltende Benutzerprofilinformationen für inaktive Profile, bei denen der Benutzername mit dem angegebenen usernameToMatch Parameter übereinstimmt.

Beispiele

Das folgende Codebeispiel zeigt die Methodensignatur für eine Implementierung der FindInactiveProfilesByUserName 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 FindInactiveProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    DateTime userInactiveSinceDate,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

Public Overrides Function FindInactiveProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal userInactiveSinceDate As DateTime, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Hinweise

Die FindInactiveProfilesByUserName Methode wird verwendet, um Profilinformationen für nicht verwendete Benutzerprofile für Profile abzurufen, 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. Von den durchsuchten Profilen wird jedes Profil mit einem LastActivityDate Profil, das auf oder vor der Rückgabe des angegebenen userInactiveSinceDate Parameterwerts auftritt, zurückgegeben.

Wenn Ihre Datenquelle zusätzliche Suchfunktionen wie z. B. Wildcardzeichen unterstützt, können Sie umfangreichere Suchfunktionen für Benutzernamen bereitstellen.

Die zurückgegebenen FindInactiveProfilesByUserName 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.

Gilt für:

Weitere Informationen