ProfileProvider.FindInactiveProfilesByUserName Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Profile

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Po zastąpieniu w klasie pochodnej pobiera informacje o profilu dla profilów, w których data ostatniego działania miała miejsce lub przed określoną datą, a nazwa użytkownika jest zgodna z określoną nazwą użytkownika.

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

Parametry

authenticationOption: ProfileAuthenticationOption

ProfileAuthenticationOption Jedną z wartości, określając, czy są zwracane anonimowe, uwierzytelnione, czy oba typy profilów.

usernameToMatch: String

Nazwa użytkownika do wyszukania.

userInactiveSinceDate: DateTime

Element DateTime określający, które profile użytkowników są uznawane za nieaktywne. LastActivityDate Jeśli wartość profilu użytkownika przypada lub przed tą datą i godziną, profil jest uznawany za nieaktywny.

pageIndex: Int32

Indeks strony wyników do zwrócenia.

pageSize: Int32

Rozmiar strony wyników do zwrócenia.

totalRecords: Int32

Gdy ta metoda zwróci wartość , zawiera łączną liczbę profilów.

Zwraca

ProfileInfoCollection

Zawierający ProfileInfoCollection informacje o profilu użytkownika dla nieaktywnych profilów, w których nazwa użytkownika jest zgodna z podanym usernameToMatch parametrem.

Przykłady

Poniższy przykład kodu przedstawia sygnaturę metody dla implementacji FindInactiveProfilesByUserName metody . Przykład pełnej ProfileProvider implementacji można znaleźć w temacie How to: Build and Run the Profile Provider Example (Instrukcje: kompilowanie i uruchamianie dostawcy profilu).

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

Uwagi

Metoda FindInactiveProfilesByUserName służy do pobierania informacji o profilu dla nieużywanych profilów użytkowników dla profilów, w których nazwa użytkownika jest zgodna z podanym usernameToMatch parametrem. Zwracane są tylko dane określone applicationName w pliku konfiguracji. Parametr authenticationOption określa, czy są przeszukiwane tylko profile anonimowe, tylko profile uwierzytelnione, czy wszystkie profile. Spośród przeszukanych profilów każdy profil, LastActivityDate który występuje na lub przed zwróceniem określonej userInactiveSinceDate wartości parametru.

Jeśli źródło danych obsługuje dodatkowe możliwości wyszukiwania, takie jak symbole wieloznaczne, możesz zapewnić bardziej rozbudowane możliwości wyszukiwania nazw użytkowników.

Wyniki zwracane przez FindInactiveProfilesByUserName element są ograniczone przez pageIndex parametry i pageSize . Parametr pageSize określa maksymalną liczbę ProfileInfo obiektów, które mają być zwracane w obiekcie ProfileInfoCollection. Parametr pageIndex określa, która strona wyników ma być zwracana, gdzie zero identyfikuje pierwszą stronę. Parametr totalRecords jest parametrem ustawionym na łączną out liczbę nieaktywnych profilów użytkowników skonfigurowanych applicationNamena podstawie parametrów authenticationOption i userInactiveSinceDate . Jeśli na przykład skonfigurowano applicationName13 użytkowników, a pageIndex wartość to 1 z wartością pageSize 5, ProfileInfoCollection zwrócona wartość będzie zawierać szóstą liczbę do dziesięciu nieaktywnych profilów zwróconych. Parametr totalRecords zostanie ustawiony na wartość 13.

Dotyczy