ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Method

Definición

Obtiene una colección de todos los usuarios almacenados en un origen de datos de Active Directory.Gets a collection of all the users stored in an Active Directory data source.

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 *  -> System.Web.Security.MembershipUserCollection
Public Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parámetros

pageIndex
Int32 Int32 Int32 Int32

El índice de la página de resultados que se va a devolver.The index of the page of results to return. pageIndex se basa en cero.pageIndex is zero-based.

pageSize
Int32 Int32 Int32 Int32

Tamaño de la página de resultados que se va a devolver.The size of the page of results to return.

totalRecords
Int32 Int32 Int32 Int32

El resultado que devuelva este método contendrá el número total de registros devueltos de la colección.When this method returns, contains the total number of records returned in the collection. Este parámetro se pasa sin inicializar.This parameter is passed uninitialized.

Devoluciones

MembershipUserCollection que contiene instancias de pageSizeMembershipUser a partir de la página especificada por pageIndex.A MembershipUserCollection containing pageSizeMembershipUser instances beginning at the page specified by pageIndex.

Excepciones

pageIndex es menor que 0.pageIndex is less than 0.

O bien-or pageSize es menor que 1.pageSize is less than 1.

O bien-or- pageSize multiplicado por pageIndex, más pageSize, menos 1 es mayor que MaxValue.pageSize multiplied by pageIndex, plus pageSize, minus 1 is greater than MaxValue.

Comentarios

Este método es invocado por el Membership clase para recuperar información de usuario desde el almacén de datos de Active Directory especificado en el archivo de configuración de la aplicación ASP.NET.This method is called by the Membership class to retrieve user information from the Active Directory data store specified in the ASP.NET application's configuration file.

Los resultados devueltos por la GetAllUsers método están restringidas por la pageIndex y pageSize parámetros.The results returned by the GetAllUsers method are constrained by the pageIndex and pageSize parameters. El pageSize parámetro especifica el número máximo de MembershipUser instancias para devolver en el MembershipUserCollection colección.The pageSize parameter specifies the maximum number of MembershipUser instances to return in the MembershipUserCollection collection. El pageIndex parámetro especifica qué página de resultados que se va a devolver, donde 0 (cero) indica la primera página.The pageIndex parameter specifies which page of results to return, where 0 (zero) indicates the first page.

El totalRecords parámetro es un out parámetro que se establece en el número total de usuarios de pertenencia coincidente se encuentra en el almacén de datos de Active Directory.The totalRecords parameter is an out parameter that is set to the total number of matching membership users found in the Active Directory data store. Por ejemplo, si hay 13 usuarios para el almacén de datos configurado y el pageIndex valor fue 1 co pageSize de 5, el MembershipUserCollection devuelto contendrá del sexto al décimo usuario.For example, if there are 13 users for the configured data store, and the pageIndex value was 1 with la pageSize of 5, the MembershipUserCollection returned would contain the sixth through the tenth users. El totalRecords parámetro se establecería en 13.The totalRecords parameter would be set to 13.

Puede controlar si se permite la búsqueda de los usuarios estableciendo el EnableSearchMethods propiedad de configuración de la aplicación de archivos mediante el enableSearchMethods atributo de la pertenencia Element (ASP.NET Settings Schema) elemento.You can control whether to allow searching for users by setting the EnableSearchMethods property in the application's configuration file using the enableSearchMethods attribute of the membership Element (ASP.NET Settings Schema) element. Establecer el EnableSearchMethods propiedad false hace que el GetAllUsers método inicie una NotSupportedException excepción.Setting the EnableSearchMethods property to false causes the GetAllUsers method to throw a NotSupportedException exception.

El proveedor usa una búsqueda de subárbol comenzando en el punto de búsqueda especificado en la cadena de conexión.The provider uses a subtree search starting at the search point specified in the connection string. Vea el ActiveDirectoryMembershipProvider tema para obtener más información acerca de las cadenas de conexión de la clase.See the ActiveDirectoryMembershipProvider class topic for more information about connection strings.

Se recomienda que no habilite la búsqueda en los sistemas de producción hasta que haya confirmado que las consultas de búsqueda emiten por la ActiveDirectoryMembershipProvider clase no afectan negativamente al rendimiento del servidor de directorio.We recommend that you do not enable searching on production systems until you have confirmed that the search queries issued by the ActiveDirectoryMembershipProvider class do not adversely impact your directory server's performance. Puesto que la ActiveDirectoryMembershipProvider clase está diseñada para un entorno Web sin estado, no puede utilizar las optimizaciones de paginación expuestas por subyacente System.DirectoryServices API.Since the ActiveDirectoryMembershipProvider class is designed for a stateless Web environment, it is unable to use the paging optimizations exposed by the underlying System.DirectoryServices APIs. Esto significa que las operaciones de paginación durante las búsquedas en los directorios grandes son muy costosas y deben evitarse.This means that paging operations during searches against large directories are very expensive and should be avoided. Las operaciones de búsqueda siempre se emiten en el servidor de directorio configurado en la cadena de conexión o un servidor seleccionado automáticamente en el caso de una cadena de conexión que señala a un dominio.Search operations are always issued against the directory server configured in the connection string, or an automatically selected server in the case of a connection string pointing at a domain. El proveedor no utiliza un catálogo global para sus métodos de búsqueda.The provider does not use a global catalog for its search methods.

Se aplica a

Consulte también: