Udostępnij za pośrednictwem

ProfileProvider.FindProfilesByUserName Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Profile
Zestaw:
System.Web.dll

Po zastąpieniu w klasie pochodnej pobiera informacje o profilu dla profilów, w których nazwa użytkownika jest zgodna z określonymi nazwami użytkowników.

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

ProfileAuthenticationOption Jedna z wartości, określająca, czy są zwracane anonimowe, uwierzytelnione, czy oba typy profilów.

usernameToMatch
String

Nazwa użytkownika do wyszukania.

pageIndex
Int32

Indeks strony wyników do zwrócenia.

pageSize
Int32

Rozmiar strony wyników do zwrócenia.

totalRecords
Int32

Gdy ta metoda zostanie zwrócona, zawiera łączną liczbę profilów.

Zwraca

ProfileInfoCollection

Informacje ProfileInfoCollection o profilu użytkownika dla profilów, w których nazwa użytkownika jest zgodna z podanym usernameToMatch parametrem.

Przykłady

Poniższy przykład kodu przedstawia podpis metody dla implementacji FindProfilesByUserName metody . Przykład pełnej ProfileProvider implementacji można znaleźć w temacie How to: Build and Run the Profile Provider Example (Instrukcje: kompilowanie i uruchamianie dostawcy 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

Uwagi

Metoda FindProfilesByUserName zwraca listę informacji o profilu dla profilów, w których nazwa użytkownika jest zgodna z podanym usernameToMatch parametrem. Zwracane są tylko dane określone applicationName w pliku konfiguracji. Parametr authenticationOption określa, czy przeszukiwane są tylko profile anonimowe, tylko profile uwierzytelnione, czy wszystkie profile.

Jeśli źródło danych obsługuje dodatkowe możliwości wyszukiwania, takie jak symbole wieloznaczne, możesz zapewnić bardziej rozbudowane możliwości wyszukiwania nazw użytkowników.

Wyniki zwracane przez FindProfilesByUserName element są ograniczone przez pageIndex parametry i pageSize . Parametr pageSize identyfikuje maksymalną liczbę ProfileInfo obiektów, które mają być zwracane w obiekcie ProfileInfoCollection. Parametr pageIndex określa, która strona wyników ma być zwracana, gdzie zero identyfikuje pierwszą stronę. Parametr totalRecords jest parametrem ustawionym out na całkowitą liczbę nieaktywnych profilów użytkowników dla skonfigurowanego applicationNameparametru authenticationOption , na podstawie parametrów i userInactiveSinceDate . Jeśli na przykład skonfigurowano applicationName13 użytkowników, a pageIndex wartość to 1 z wartością pageSize 5, ProfileInfoCollection zwrócona wartość będzie zawierać szósty do dziesięciu nieaktywnych profilów zwróconych. Parametr totalRecords zostanie ustawiony na wartość 13.

Dotyczy

Zobacz też