Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método ActiveDirectoryMembershipProvider.FindUsersByEmail (String, Int32, Int32, Int32)

 

Publicado: octubre de 2016

Devuelve una colección de usuarios de pertenencia desde el almacén de datos de Active Directory basándose en la dirección de correo electrónico del usuario.

Espacio de nombres:   System.Web.Security
Ensamblado:  System.Web (en System.Web.dll)

[DirectoryServicesPermissionAttribute(SecurityAction.Assert, 
	Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.Demand, 
	Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.InheritanceDemand, 
	Unrestricted = true)]
public override MembershipUserCollection FindUsersByEmail(
	string emailToMatch,
	int pageIndex,
	int pageSize,
	out int totalRecords
)

Parámetros

emailToMatch
Type: System.String

Dirección de correo electrónico o parte de la dirección de correo electrónico para buscar.

pageIndex
Type: System.Int32

Índice de la página de resultados que se va a devolver. pageIndex es de base cero.

pageSize
Type: System.Int32

Tamaño de la página de resultados que se va a devolver.

totalRecords
Type: System.Int32

Cuando este método vuelve, contiene el número total de usuarios devueltos de la colección. Este parámetro se pasa sin inicializar.

Valor devuelto

Type: System.Web.Security.MembershipUserCollection

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

Exception Condition
InvalidOperationException

El FindUsersByEmail se invoca antes de la ActiveDirectoryMembershipProvider se inicializa la instancia.

ArgumentException

emailToMatch está vacía.

o bien

emailToMatch supera los 256 caracteres.

o bien

pageIndex es menor que 0.

o bien

pageSize es menor que 1.

o bien

pageSize multiplicado por pageIndex, además de pageSize, menos 1 es mayor que MaxValue.

NotSupportedException

La propiedad EnableSearchMethods es false.

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

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

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

Los resultados devueltos por la FindUsersByEmail método están limitados por el pageIndex y pageSize parámetros. El pageSize parámetro especifica el número máximo de MembershipUser instancias para devolver en el MembershipUserCollection. El pageIndex parámetro especifica qué 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 establecido para el número total de usuarios suscritos coincidentes que se encuentra 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 es 1 con un pageSize de 5, la MembershipUserCollection devuelta contendría del sexto al décimo usuario. El totalRecords parámetro se establecería en 13.

Puede controlar si se permite la búsqueda de usuarios, estableciendo el EnableSearchMethods archivos de propiedad en la configuración de la aplicación mediante el enableSearchMethods atributo de la membership Element (ASP.NET Settings Schema) elemento. Establecer el EnableSearchMethods propiedad false hace que el FindUsersByEmail método produzca un NotSupportedException excepción.

El proveedor utiliza la búsqueda de subárbol comenzando en el punto de búsqueda especificado en la cadena de conexión. Vea el ActiveDirectoryMembershipProvider tema de la clase para obtener más información acerca de las cadenas de conexión.

Se recomienda que no habilite la búsqueda en sistemas de producción hasta que haya confirmado que las consultas de búsqueda emitido por la ActiveDirectoryMembershipProvider clase no afectan negativamente al rendimiento del servidor de directorio. Dado 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. 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 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
Disponible desde 2.0
Volver al principio
Mostrar: