ProfileProvider.FindInactiveProfilesByUserName Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Při přepsání v odvozené třídě načte informace 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ž 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ý applicationName
parametr na základě authenticationOption
parametrů a userInactiveSinceDate
. Pokud je například pro nakonfigurovaný applicationName
objekt 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.