Compartir a través de


MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Método

Definición

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.MembershipUserCollection
Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Pará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.

Se aplica a

Consulte también