ProfileProvider.FindProfilesByUserName Metoda

Definice

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

ProfileInfoCollection

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 applicationNamena authenticationOption základě parametrů a userInactiveSinceDate parametrů. Pokud je například nakonfigurovaných applicationName13 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.

Platí pro

Viz také