MembershipProvider.FindUsersByEmail(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 la dirección de correo contiene la dirección de correo electrónico especificada que necesita coincidir.
public:
abstract System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public MustOverride Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
Parámetros
- emailToMatch
- String
Dirección de correo electrónico 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 pageSize
MembershipUser 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
FindUsersByEmail devuelve una lista de usuarios de pertenencia donde la dirección de correo electrónico del usuario coincide con la proporcionada emailToMatch
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 las direcciones de correo electrónico.
Los resultados devueltos por FindUsersByEmail 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 emailToMatch
valor. Por ejemplo, si se encontraron 13 usuarios en emailToMatch
los que la parte coincidente de o toda la dirección de correo electrónico, y el pageIndex
valor era 1 con un pageSize
valor de 5, el MembershipUserCollection contendrá el sexto al décimo usuario devuelto.
totalRecords
se establecería en 13.