ProfileProvider.FindProfilesByUserName Metoda

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

Zwraca

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.

Zobacz też

• Implementowanie dostawcy profilu
• ASP.NET — omówienie właściwości profilu