ProfileProvider.GetAllInactiveProfiles 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 Benutzerprofildaten aus der Datenquelle für Profile ab, bei denen das Datum der letzten Aktivität an oder vor dem angegebenen Datum liegt.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ GetAllInactiveProfiles(System::Web::Profile::ProfileAuthenticationOption authenticationOption, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Profile.ProfileInfoCollection GetAllInactiveProfiles (System.Web.Profile.ProfileAuthenticationOption authenticationOption, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

abstract member GetAllInactiveProfiles : System.Web.Profile.ProfileAuthenticationOption * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollection

Public MustOverride Function GetAllInactiveProfiles (authenticationOption As ProfileAuthenticationOption, 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.

userInactiveSinceDate: DateTime

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

pageIndex: Int32

Der Index der zurückgegebenen 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 zu den inaktiven Profilen enthält.

Beispiele

Das folgende Codebeispiel zeigt die Methodensignatur für eine Implementierung der GetAllInactiveProfiles -Methode. Ein Beispiel für eine vollständige ProfileProvider Implementierung finden Sie unter Vorgehensweise: Erstellen und Ausführen des Profilanbieterbeispiels.

public override ProfileInfoCollection GetAllInactiveProfiles(
    ProfileAuthenticationOption authenticationOption,
    DateTime userInactiveSinceDate,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

Public Overrides Function GetAllInactiveProfiles( _
ByVal authenticationOption As ProfileAuthenticationOption, _
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 GetAllInactiveProfiles -Methode wird verwendet, um Profilinformationen für nicht verwendete Benutzerprofile abzurufen. 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 dem angegebenen userInactiveSinceDate Parameterwert auftritt, zurückgegeben.

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

Gilt für: