Sdílet prostřednictvím

ProfileProvider.FindProfilesByUserName Metoda

  • Reference

Definice

Obor názvů:
System.Web.Profile
Sestavení:
System.Web.dll

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

Viz také