ProfileProvider.FindProfilesByUserName Metoda

Reference

Definice

Obor názvů:: System.Web.Profile

Sestavení:: System.Web.dll

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 o profilu 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 se vrátí 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 mají vrátit.

totalRecords: Int32

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

Návraty

ProfileInfoCollection

Obsahuje 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 signaturu 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 určená applicationName v konfiguračním souboru. Parametr authenticationOption určuje, jestli se prohledávají pouze anonymní profily, pouze ověřené profily nebo všechny profily.

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

Výsledky vrácené nástrojem FindProfilesByUserName jsou omezené pageIndex parametry a pageSize . Parametr pageSize určuje maximální počet objektů, které ProfileInfo 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 authenticationOption základě 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 by obsahovala šestý až desátý vrácený neaktivní profil. Parametr totalRecords by byl nastaven na hodnotu 13.

Platí pro

Sdílet prostřednictvím