ProfileProvider.FindInactiveProfilesByUserName Metoda

Definice

Při přepsání v odvozené třídě načte informace o profilu pro profily, ve kterých došlo k datu poslední aktivity k zadanému datu nebo před a uživatelské jméno odpovídá zadanému uživatelskému jménu.

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

Jedna z ProfileAuthenticationOption hodnot určující, jestli se vrátí anonymní, ověřený nebo oba typy profilů.

usernameToMatch
String

Uživatelské jméno, které chcete vyhledat.

userInactiveSinceDate
DateTime

A DateTime , který identifikuje, které profily uživatelů jsou považovány za neaktivní. Pokud hodnota LastActivityDate profilu uživatele nastane k tomuto datu a času nebo před tímto datem a časem, profil se považuje za neaktivní.

pageIndex
Int32

Index stránky výsledků, které se mají vrátit.

pageSize
Int32

Velikost stránky výsledků, které se mají vrátit.

totalRecords
Int32

Když se tato metoda vrátí, obsahuje celkový počet profilů.

Návraty

Obsahující ProfileInfoCollection informace o profilu uživatele pro neaktivní profily, kde uživatelské jméno odpovídá zadanému usernameToMatch parametru.

Příklady

Následující příklad kódu ukazuje signaturu metody pro implementaci FindInactiveProfilesByUserName metody. Příklad úplné ProfileProvider implementace najdete v tématu Postupy: Sestavení a spuštění příkladu zprostředkovatele 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

Poznámky

Metoda FindInactiveProfilesByUserName se používá k načtení informací o profilu pro nepoužívané profily uživatelů pro profily, ve kterých uživatelské jméno odpovídá zadanému usernameToMatch parametru. Vrátí se applicationName pouze data pro zadané v konfiguračním souboru. Parametr authenticationOption určuje, jestli se prohledávají pouze anonymní profily, pouze ověřené profily nebo všechny profily. Z prohledáných profilů se vrátí jakýkoli profil s LastActivityDate hodnotou zadaného userInactiveSinceDate parametru nebo před tím.

Pokud zdroj dat podporuje další možnosti vyhledávání, například zástupné znaky, můžete pro uživatelská jména poskytnout rozsáhlejší možnosti vyhledávání.

Výsledky vrácené nástrojem FindInactiveProfilesByUserName jsou omezeny pageIndex parametry a pageSize . Parametr pageSize identifikuje maximální počet ProfileInfo objektů, které se mají vrátit v objektu ProfileInfoCollection. Parametr pageIndex určuje, která stránka výsledků se má vrátit, kde nula identifikuje první stránku. Parametr totalRecords je out parametr, který je nastavený na celkový počet neaktivních profilů uživatelů pro nakonfigurovaný applicationNameparametr na základě authenticationOption parametrů a userInactiveSinceDate . Pokud je například pro nakonfigurovaný applicationNameobjekt 13 uživatelů a pageIndex hodnota je 1 s pageSize hodnotou 5, ProfileInfoCollection vrácená hodnota bude obsahovat šestý až desátý vrácený neaktivní profil. Parametr totalRecords by byl nastavený na hodnotu 13.

Platí pro

Viz také