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

Referencia

Definición

Espacio de nombres:: System.Web.Security

Ensamblado:: System.Web.dll

Ensamblado:: System.Web.ApplicationServices.dll

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

MembershipUserCollection

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, vea Implementar 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 ApplicationName configurada. 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 FindUsersByName devueltos por están restringidos por los pageIndex parámetros y pageSize . El pageSize parámetro identifica el número de objetos que se MembershipUser devolverán en la MembershipUserCollection colección. El parámetro identifica la página de resultados que se pageIndex va a devolver, donde 0 identifica la primera página. El parámetro es un parámetro que se establece en el número total de usuarios de totalRecords pertenencia que out coincidieron con el usernameToMatch valor. Por ejemplo, si se encontraron 13 usuarios donde coincidía con parte de o el nombre de usuario completo, y el valor era 1 con un de 5, contendrá el sexto hasta el décimo usuario usernameToMatch pageIndex pageSize MembershipUserCollection devuelto. totalRecords se establecería en 13.

Se aplica a