Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
MembershipProvider.FindUsersByName (Método)
Obtiene una colección de usuarios de pertenencia donde el nombre de usuario contiene el nombre de usuario especificado para su coincidencia.
Ensamblado: System.Web.ApplicationServices (en System.Web.ApplicationServices.dll)
public abstract MembershipUserCollection FindUsersByName( string usernameToMatch, int pageIndex, int pageSize, out int totalRecords )
Parámetros
- usernameToMatch
- Tipo: System.String
Nombre de usuario que se va a buscar.
- pageIndex
- Tipo: System.Int32
El índice de la página de resultados que se va a devolver. pageIndex se basa en cero.
- pageSize
- Tipo: System.Int32
Tamaño de la página de resultados que se va a devolver.
- totalRecords
- Tipo: System.Int32%
Número total de usuarios coincidentes.
Valor devuelto
Tipo: System.Web.Security.MembershipUserCollectionColección MembershipUserCollection que contiene una página de objetos pageSizeMembershipUser que comienzan en la página especificada por pageIndex.
FindUsersByName devuelve una lista de usuarios de pertenencia donde el nombre de usuario coincide con el valor de usernameToMatch proporcionado para la propiedad ApplicationName configurada. Si el origen de datos admite funciones de búsqueda adicionales, como caracteres comodín, puede incluir funciones de búsqueda más avanzadas para los nombres de usuario.
Los resultados devueltos por el método FindUsersByName están restringidos por los parámetros pageIndex y pageSize. El parámetro pageSize identifica el número de objetos MembershipUser que se van devolver en la colección MembershipUserCollection. El parámetro pageIndex identifica qué pagina de resultados se va a devolver, donde 0 representa 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 que coinciden con el valor de usernameToMatch. Por ejemplo, si se encontraran 13 usuarios en los que usernameToMatch coincidiera con una parte o la totalidad del nombre de usuario, si el valor de pageIndex fuera 1 y el de pageSize fuera 5, la colección MembershipUserCollection contendría del sexto al décimo usuario devueltos. El valor de totalRecords sería 13.
Para obtener un ejemplo de implementación de MembershipProvider, vea Implementar un proveedor de perfiles.
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
