ProfileProvider.FindInactiveProfilesByUserName Methode

Referenz

Definition

Namespace:: System.Web.Profile

Assembly:: System.Web.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 beim Überschreiben in einer abgeleiteten Klasse Profilinformationen für Profile ab, bei denen das Datum der letzten Aktivität an oder vor dem angegebenen Datum liegt und bei denen der Benutzername dem angegebenen Benutzernamen entspricht.

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 anonyme Profile, authentifizierte Profile oder beide Profilarten zurückgegeben werden.

usernameToMatch: String

Der zu suchende Benutzername.

userInactiveSinceDate: DateTime

Ein DateTime, der festlegt, welche Benutzerprofile als inaktiv betrachtet werden. Wenn der LastActivityDate-Wert eines Benutzerprofils an oder vor diesem Zeitpunkt (Datum und Uhrzeit) auftritt, gilt das Profil als inaktiv.

pageIndex: Int32

Der Index der zurückzugebenden Ergebnisseite.

pageSize: Int32

Die Größe der zurückzugebenden Ergebnisseite.

totalRecords: Int32

Diese Methode enthält bei der Rückgabe die Gesamtzahl von Profilen.

Gibt zurück

ProfileInfoCollection

Eine ProfileInfoCollection, die Benutzerprofilinformationen für inaktive Profile enthält, in denen der Benutzername dem angegebenen usernameToMatch-Parameter entspricht.

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 Vorgehensweise: Erstellen und Ausführen des Profilanbieterbeispiels.

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 jedes Profil mit einem LastActivityDate , das am oder vor dem angegebenen userInactiveSinceDate Parameterwert auftritt, wird zurückgegeben.

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

Die von FindInactiveProfilesByUserName zurückgegebenen Ergebnisse werden durch die pageIndex Parameter und pageSize eingeschränkt. Der pageSize -Parameter gibt die maximale Anzahl von ProfileInfo Objekten an, die ProfileInfoCollectionin zurückgegeben werden sollen. 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 Gesamtzahl inaktiver Benutzerprofile für das konfigurierte applicationNamefestgelegt ist, basierend auf den authenticationOption Parametern und userInactiveSinceDate . Wenn es beispielsweise 13 Benutzer für die konfigurierte applicationNamegibt und der pageIndex Wert 1 mit einem pageSize von 5 ist, enthält das ProfileInfoCollection zurückgegebene das sechste bis zehnte zurückgegebene inaktive Profil. Der totalRecords Parameter wird auf 13 festgelegt.

Gilt für: