MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene una colección de usuarios de pertenencia donde el nombre de usuario contiene el nombre de usuario especificado para su coincidencia.
public:
abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollectionPublic MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParámetros
- usernameToMatch
- String
El nombre de usuario que se va a buscar.
- pageIndex
- Int32
Índice de la página de resultados que se va a devolver.
pageIndex es de base cero.
- pageSize
- Int32
Tamaño de la página de resultados que se va a devolver.
- totalRecords
- Int32
Número total de usuarios coincidentes.
Devoluciones
Colección MembershipUserCollection que contiene una página de objetos pageSizeMembershipUser que comienza en la página especificada por el parámetro pageIndex.
Ejemplos
Para obtener un ejemplo de una MembershipProvider implementación, consulte Implementación de un proveedor de perfiles.
Comentarios
FindUsersByName devuelve una lista de usuarios de pertenencia donde el nombre de usuario coincide con el proporcionado usernameToMatch para la propiedad configurada ApplicationName . Si el origen de datos admite funcionalidades de búsqueda adicionales, como caracteres comodín, puede proporcionar funcionalidades de búsqueda más amplias para los nombres de usuario.
Los resultados devueltos por FindUsersByName están restringidos por los pageIndex parámetros y pageSize . El pageSize parámetro identifica el número de MembershipUser objetos que se van a devolver en la MembershipUserCollection colección. El pageIndex parámetro identifica la página de resultados que se va a devolver, donde 0 identifica 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 que coinciden con el usernameToMatch valor. Por ejemplo, si se encontraron 13 usuarios en usernameToMatch los que coincidía con parte de o el nombre de usuario completo, y el pageIndex valor era 1 con un pageSize de 5, el MembershipUserCollection contendrá el sexto al décimo usuario devuelto.
totalRecords se establecería en 13.
