ActiveDirectoryMembershipProvider.FindUsersByEmail (Método)

El método FindUsersByEmail obtiene MembershipUserCollection que contiene los registros de usuario del almacén de Active Directory que coinciden con los parámetros emailToMatch. Los registros de usuario se devuelven ordenados en orden ascendente por dirección de correo electrónico.

El parámetro emailToMatch está limitado a 256 caracteres.

La clase ActiveDirectoryMembershipProvider emitirá la búsqueda mediante los valores de configuración clientSearchTimeout y serverSearchTimeout. Dado que la clase ActiveDirectoryMembershipProvider realiza una búsqueda en el servidor de directorio utilizando páginas de 512 filas por página, se aplican a cada página los tiempos de espera de resultados obtenidos por la clase ActiveDirectoryMembershipProvider. Por ejemplo, si una consulta de búsqueda produce 1.000 filas de datos, la clase ActiveDirectoryMembershipProvider obtendrá esta información como dos páginas de datos. Esto significa que los tiempos de espera del cliente y de la búsqueda iniciarán el recuento desde cero cuando la clase ActiveDirectoryMembershipProvider solicite la segunda página de datos.

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

El parámetro totalRecords es un parámetro out 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 valor de pageIndex es 1 con un pageSize de 5, la colección MembershipUserCollection que se devuelva contendrá del sexto al décimo usuario. El parámetro totalRecords se establecería en 13.

Puede controlar si se va a permitir la búsqueda de usuarios, estableciendo la propiedad EnableSearchMethods del archivo de configuración de la aplicación con el atributo enableSearchMethods del elemento Elemento membership (Esquema de configuración de ASP.NET). Establecer la propiedad EnableSearchMethods en false hace que el método FindUsersByEmail produzca una excepción NotSupportedException.

El proveedor utiliza la búsqueda de subárbol comenzando en el punto de búsqueda especificado de la cadena de conexión. Para obtener más información sobre cadenas de conexión, vea el tema de la clase ActiveDirectoryMembershipProvider.

Le recomendamos que no habilite la búsqueda en sistemas de producción hasta que no haya confirmado que las consultas de búsqueda emitidas por la clase ActiveDirectoryMembershipProvider no influyen desfavorablemente en el rendimiento del servidor de directorio. Dado que la clase ActiveDirectoryMembershipProvider se ha diseñado para un entorno Web sin estado, no se pueden utilizar las optimizaciones de paginación expuestas por las API System.DirectoryServices subyacentes. Esto significa que las operaciones de paginación durante las búsquedas en directorios de gran tamaño son muy caras y se deberían evitar. 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. El proveedor no utiliza un catálogo global para sus métodos de búsqueda.

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

Referencia

Otros recursos