ProfileProvider.FindProfilesByUserName Metodo

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

Parametri

Valori restituiti

Oggetto ProfileInfoCollection contenente informazioni sul profilo utente per i profili in cui il nome utente corrisponde al parametro specificato usernameToMatch .

Esempio

Nell'esempio di codice seguente viene illustrata la firma del metodo per un'implementazione del FindProfilesByUserName metodo . Per un esempio di implementazione completa ProfileProvider , vedere Procedura: Compilare ed eseguire l'esempio del provider di profili.

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

Commenti

Il FindProfilesByUserName metodo restituisce un elenco di informazioni sul profilo per i profili in cui il nome utente corrisponde al parametro fornito usernameToMatch . Vengono restituiti solo i dati per l'oggetto applicationName specificato nel file di configurazione. Il authenticationOption parametro specifica se vengono cercati solo profili anonimi, solo profili autenticati o tutti i profili.

Se l'origine dati supporta funzionalità di ricerca aggiuntive, come i caratteri jolly, potete ampliare le capacità di ricerca per i nomi utente.

I risultati restituiti da FindProfilesByUserName sono vincolati dai pageIndex parametri e pageSize . Il pageSize parametro identifica il numero massimo di ProfileInfo oggetti da restituire nell'oggetto ProfileInfoCollection. Il pageIndex parametro identifica la pagina dei risultati da restituire, dove zero identifica la prima pagina. Il totalRecords parametro è un out parametro impostato sul numero totale di profili utente inattivi per l'oggetto configurato applicationNamein base ai authenticationOption parametri e userInactiveSinceDate . Ad esempio, se sono presenti 13 utenti per l'oggetto configurato applicationNamee il pageIndex valore è 1 con un pageSize valore pari a 5, il ProfileInfoCollection valore restituito conterrà il sesto tramite il decimo profilo inattivo restituito. Il totalRecords parametro verrà impostato su 13.

Vedi anche

• Implementazione di un provider di profili
• Panoramica delle proprietà del profilo ASP.NET