ProfileProvider.FindProfilesByUserName 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 profilové informace pro profily, ve kterých uživatelské jméno odpovídá zadaným uživatelským jménům.
public:
abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection
Parametry
- authenticationOption
- ProfileAuthenticationOption
Jedna z ProfileAuthenticationOption hodnot určující, jestli jsou vráceny anonymní, ověřené nebo oba typy profilů.
- usernameToMatch
- String
Uživatelské jméno, které chcete vyhledat.
- pageIndex
- Int32
Index stránky výsledků, které se mají vrátit.
- pageSize
- Int32
Velikost stránky výsledků, která se má 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 profily, kde uživatelské jméno odpovídá zadanému usernameToMatch
parametru.
Příklady
Následující příklad kódu ukazuje podpis metody pro implementaci FindProfilesByUserName metody. Příklad úplné ProfileProvider implementace najdete v tématu Postupy: Sestavení a spuštění příkladu zprostředkovatele profilu.
public override ProfileInfoCollection FindProfilesByUserName(
ProfileAuthenticationOption authenticationOption,
string usernameToMatch,
int pageIndex,
int pageSize,
out int totalRecords)
{
totalRecords = 0;
return new ProfileInfoCollection();
}
Public Overrides Function FindProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
ByRef totalRecords As Integer) As ProfileInfoCollection
totalRecords = 0
Return New ProfileInfoCollection()
End Function
Poznámky
Metoda FindProfilesByUserName vrátí seznam informací o profilu pro profily, ve kterých uživatelské jméno odpovídá zadanému usernameToMatch
parametru. Vrátí se pouze data zadaná applicationName
v konfiguračním souboru. Parametr authenticationOption
určuje, jestli se prohledávají jenom anonymní profily, jenom ověřené profily nebo všechny profily.
Pokud váš zdroj dat podporuje další možnosti vyhledávání, jako jsou zástupné znaky, můžete poskytnout rozsáhlejší možnosti hledání pro uživatelská jména.
Výsledky, které FindProfilesByUserName vrací, jsou omezené parametry pageIndex
a pageSize
parametry. Parametr pageSize
identifikuje maximální počet ProfileInfo objektů, které se mají vrátit do ProfileInfoCollectionsouboru . Parametr pageIndex
identifikuje, která stránka výsledků se má vrátit, kde nula identifikuje první stránku. Parametr totalRecords
je out
parametr nastavený na celkový počet neaktivních profilů uživatelů nakonfigurovaných applicationName
na authenticationOption
základě parametrů a userInactiveSinceDate
parametrů. Pokud je například nakonfigurovaných applicationName
13 uživatelů a pageIndex
hodnota je 1 s pageSize
hodnotou 5, ProfileInfoCollection bude vrácená hodnota obsahovat šestý až desátý vrácený neaktivní profily. Parametr totalRecords
by byl nastaven na hodnotu 13.