MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.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.

Ottiene un insieme degli utenti di appartenenza in cui il nome utente contiene il nome specificato di cui verificare la corrispondenza.

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parametri

usernameToMatch: String

Nome utente da cercare.

pageIndex: Int32

Indice della pagina di risultati da restituire. pageIndex è in base zero.

pageSize: Int32

Dimensione della pagina di risultati da restituire.

totalRecords: Int32

Numero totale di utenti individuati.

Restituisce

MembershipUserCollection

Una raccolta MembershipUserCollection che contiene una pagina di oggetti pageSizeMembershipUser che iniziano alla pagina specificata da pageIndex.

Esempio

Per un MembershipProvider esempio di implementazione, vedere Implementazione di un provider di profili.

Commenti

FindUsersByName restituisce un elenco di utenti di appartenenza in cui il nome utente corrisponde all'oggetto specificato usernameToMatch per la proprietà configurata ApplicationName . 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 FindUsersByNamepageIndex parametri e pageSize . Il pageSize parametro identifica il numero di MembershipUser oggetti da restituire nell'insieme MembershipUserCollection . Il pageIndex parametro identifica la pagina dei risultati da restituire, dove 0 identifica la prima pagina. Il totalRecords parametro è un out parametro impostato sul numero totale di utenti di appartenenza corrispondenti al usernameToMatch valore. Ad esempio, se sono stati trovati 13 utenti in cui usernameToMatch è stata trovata una parte corrispondente o l'intero nome utente e il valore era 1 con un pageSize valore pari a 5, MembershipUserCollection l'oggetto pageIndex conterrà il sesto fino al decimo utente restituito. totalRecords sarebbe impostato su 13.

Si applica a

Condividi tramite