ProfileProvider.FindProfilesByUserName Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Profile

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Se sottoposto a override in una classe derivata, recupera le informazioni sui profili in cui il nome utente corrisponde ai nomi utente specificati.

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

authenticationOption: ProfileAuthenticationOption

Uno dei valori dell'enumerazione ProfileAuthenticationOption che specifica se vengono restituiti profili di tipo anonimo, autenticato o entrambi.

usernameToMatch: String

Nome utente da cercare.

pageIndex: Int32

Indice della pagina di risultati da restituire.

pageSize: Int32

Dimensione della pagina di risultati da restituire.

totalRecords: Int32

Quando termina, il metodo contiene il numero totale di profili.

Restituisce

ProfileInfoCollection

Un oggetto ProfileInfoCollection che contiene le informazioni sui profili utente in cui il nome utente corrisponde al parametro usernameToMatch fornito.

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 specificato usernameToMatch . Vengono restituiti solo i dati specificati applicationName 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, ad esempio caratteri jolly, è possibile fornire funzionalità di ricerca più estese per i nomi utente.

I risultati restituiti da sono vincolati dai FindProfilesByUserNamepageIndex parametri e pageSize . Il pageSize parametro identifica il numero massimo di ProfileInfo oggetti da restituire in 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 il parametro configurato applicationNamein base authenticationOption ai parametri e userInactiveSinceDate . Ad esempio, se sono presenti 13 utenti per l'oggetto configurato applicationNamee il valore è 1 con un pageSize valore pari a 5, il ProfileInfoCollectionpageIndex restituito conterrà il sesto fino al decimo profili inattivi restituiti. Il totalRecords parametro verrà impostato su 13.

Si applica a