ActiveDirectoryMembershipProvider.FindUsersByName Metodo
Definizione
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.
Restituisce un insieme di utenti dall'archivio dati di Active Directory in base al nome utente.
public:
override System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public override System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
override this.FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public Overrides Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
Parametri
- usernameToMatch
- String
Nome utente o porzione del 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
Quando termina, il metodo contiene il numero totale di record restituiti nell'insieme. Questo parametro viene passato non inizializzato.
Restituisce
Oggetto MembershipUserCollection che contiene le istanze di pageSize
MembershipUser che iniziano alla pagina specificata da pageIndex
.
Eccezioni
Il metodo FindUsersByName(String, Int32, Int32, Int32) viene chiamato prima che venga inizializzata l'istanza della classe ActiveDirectoryMembershipProvider.
usernameToMatch
è vuoto oppure supera la lunghezza massima per il nome utente (in genere 256 caratteri).
-oppure-
usernameToMatch
contiene virgole.
-oppure-
pageIndex
è minore di 0.
-oppure–
pageSize
è minore di 1.
-oppure-
pageSize
moltiplicato per pageIndex
, più pageSize
, meno 1 è maggiore di Int32.MaxValue.
usernameToMatch
è null
.
La proprietà EnableSearchMethods è false
.
Commenti
Il FindUsersByName metodo restituisce un'istanza MembershipUserCollection contenente i record utente dall'archivio dati di Active Directory per tutti i nomi utente corrispondenti ai userNameToMatch
parametri. I record vengono restituiti in ordine alfabetico in base al nome utente.
I risultati restituiti dal metodo sono vincolati dai FindUsersByNamepageIndex
parametri e pageSize
. Il pageSize
parametro specifica il numero massimo di MembershipUser istanze da restituire in MembershipUserCollection. Il pageIndex
parametro specifica la pagina dei risultati da restituire, dove 0 (zero) indica la prima pagina.
Il totalRecords
parametro è un out
parametro impostato sul numero totale di utenti di appartenenza corrispondenti trovati nell'archivio dati di Active Directory. Ad esempio, se sono presenti 13 utenti per l'archivio dati configurato e il valore era 1 con un pageSize
valore pari a 5, il pageIndex
MembershipUserCollection restituito conterrà il sesto fino al decimo utenti. Il totalRecords
parametro verrà impostato su 13.
È possibile controllare se consentire la ricerca degli utenti impostando la EnableSearchMethods proprietà nel file di configurazione dell'applicazione usando l'attributo enableSearchMethods
dell'elemento di appartenenza (ASP.NET Schema impostazioni). Impostando il valore della EnableSearchMethods proprietà in modo che false
il metodo generi un'eccezione FindUsersByNameNotSupportedException .
Il provider usa una ricerca sottoalbero a partire dal punto di ricerca specificato nella stringa di connessione. Per altre informazioni sulle stringhe di connessione, vedere l'argomento ActiveDirectoryMembershipProvider della classe.
È consigliabile non abilitare la ricerca nei sistemi di produzione fino a quando non è stato confermato che le query di ricerca rilasciate dalla ActiveDirectoryMembershipProvider classe non influiscono negativamente sulle prestazioni del server directory. Poiché la ActiveDirectoryMembershipProvider classe è progettata per un ambiente Web senza stato, non è possibile usare le ottimizzazioni di paging esposte dalle API sottostanti System.DirectoryServices . Ciò significa che le operazioni di paging durante le ricerche su directory di grandi dimensioni sono molto costose e devono essere evitate. Le operazioni di ricerca vengono sempre rilasciate sul server directory configurato nella stringa di connessione oppure un server selezionato automaticamente nel caso di una stringa di connessione che punta a un dominio. Il provider non usa un catalogo globale per i metodi di ricerca.