ProfileProvider.GetAllProfiles 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 für alle Profile in der Datenquelle ab.

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

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

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

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

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 für alle Profile in der Datenquelle enthält.

Beispiele

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

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

    return new ProfileInfoCollection();
}

Public Overrides Function GetAllProfiles( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Hinweise

Die GetAllProfiles -Methode wird verwendet, um Profilinformationen für alle Profile 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.

Die von GetAllInactiveProfiles 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: