ProfileProvider.FindInactiveProfilesByUserName Metoda
Definicja
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
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 applicationName
na podstawie parametrów authenticationOption
i userInactiveSinceDate
. Jeśli na przykład skonfigurowano applicationName
13 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.