ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Método

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.MembershipUserCollection

Public Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parámetros

Devoluciones

MembershipUserCollection que contiene instancias de pageSizeMembershipUser a partir de la página especificada por pageIndex.

Excepciones

Comentarios

La clase llama Membership a este método para recuperar información de usuario del almacén de datos de Active Directory especificado en el archivo de configuración de la aplicación ASP.NET.

Los resultados devueltos por el GetAllUsers método están restringidos por los pageIndex parámetros y pageSize . El pageSize parámetro especifica el número máximo de MembershipUser instancias que se van a devolver en la MembershipUserCollection colección. El pageIndex parámetro especifica la página de resultados que se va a devolver, donde 0 (cero) indica la primera página.

El totalRecords parámetro es un out parámetro que se establece en el número total de usuarios de pertenencia coincidentes que se encuentran en el almacén de datos de Active Directory. Por ejemplo, si hay 13 usuarios para el almacén de datos configurado y el pageIndex valor era 1 con la pageSize de 5, el MembershipUserCollection devuelto contendrá el sexto hasta el décimo usuarios. El totalRecords parámetro se establecería en 13.

Puede controlar si quiere permitir la búsqueda de usuarios estableciendo la EnableSearchMethods propiedad en el archivo de configuración de la aplicación mediante el enableSearchMethods atributo del elemento membership Element (ASP.NET Settings Schema). Establecer la EnableSearchMethods propiedad en false hace que el GetAllUsers método produzca una NotSupportedException excepción.

El proveedor usa una búsqueda de subárbol que comienza en el punto de búsqueda especificado en la cadena de conexión. Consulte el ActiveDirectoryMembershipProvider tema de la clase para obtener más información sobre las cadenas de conexión.

Se recomienda no habilitar la búsqueda en sistemas de producción hasta que haya confirmado que las consultas de búsqueda emitidas por la ActiveDirectoryMembershipProvider clase no afectan negativamente al rendimiento del servidor de directorios. Puesto que la ActiveDirectoryMembershipProvider clase está diseñada para un entorno web sin estado, no puede usar las optimizaciones de paginación expuestas por las API subyacentes System.DirectoryServices . Esto significa que las operaciones de paginación durante las búsquedas en directorios grandes son muy costosas y deben evitarse. Las operaciones de búsqueda siempre se emiten en el servidor de directorios configurado en la cadena de conexión o en un servidor seleccionado automáticamente en el caso de una cadena de conexión que apunta a un dominio. El proveedor no usa un catálogo global para sus métodos de búsqueda.

Se aplica a

Consulte también

• Introducción a la pertenencia a ASP.NET