ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) 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.
Ottiene l'insieme di tutti gli utenti archiviati in un archivio dati di Active Directory.
public:
override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public override System.Web.Security.MembershipUserCollection GetAllUsers (int pageIndex, int pageSize, out int totalRecords);override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollectionPublic Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParametri
- 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 pageSizeMembershipUser che iniziano alla pagina specificata da pageIndex.
Eccezioni
Il metodo GetAllUsers(Int32, Int32, Int32) viene chiamato prima che venga inizializzata l'istanza della classe ActiveDirectoryMembershipProvider.
pageIndex è minore di 0.
-oppure–
pageSize è minore di 1.
-oppure-
pageSize moltiplicato per pageIndex, più pageSize, meno 1 è maggiore di Int32.MaxValue.
La proprietà EnableSearchMethods è false.
Commenti
Questo metodo viene chiamato dalla Membership classe per recuperare le informazioni utente dall'archivio dati di Active Directory specificato nel file di configurazione dell'applicazione ASP.NET.
I risultati restituiti dal GetAllUsers metodo sono vincolati dai pageIndex parametri e pageSize . Il pageSize parametro specifica il numero massimo di MembershipUser istanze da restituire nella MembershipUserCollection raccolta. 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 pageIndex valore era 1 con la pageSize di 5, il MembershipUserCollection restituito conterrà il sesto al decimo utente. Il totalRecords parametro verrà impostato su 13.
È possibile controllare se consentire la ricerca di utenti impostando la EnableSearchMethods proprietà nel file di configurazione dell'applicazione usando l'attributo enableSearchMethodsdell'elemento membership Element (ASP.NET Settings Schema). Se si imposta la EnableSearchMethods proprietà su false , il GetAllUsers metodo genera un'eccezione NotSupportedException .
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 relativo alla ActiveDirectoryMembershipProvider classe.
È consigliabile non abilitare la ricerca nei sistemi di produzione finché non si è verificato che le query di ricerca eseguite 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 eseguite sul server di directory configurato nella stringa di connessione o su 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.
