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

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Obtém uma coleção de usuários associados na qual o endereço de email contém o endereço de email especificado a ser correspondido.

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

O endereço de email a ser pesquisado.

pageIndex

Int32

O índice da página de resultados a serem retornados. pageIndex é baseado em zero.

pageSize

Int32

O tamanho da página de resultados a ser retornada.

totalRecords

Int32

O número total de usuários correspondentes.

Retornos

MembershipUserCollection

Uma coleção MembershipUserCollection que contém uma página de objetos pageSizeMembershipUser começando na página especificada por pageIndex.

Exemplos

Para obter um exemplo de implementação MembershipProvider , consulte Implementando um provedor de perfil.

Comentários

FindUsersByEmail retorna uma lista de usuários de associação em que o endereço de email do usuário corresponde ao fornecido emailToMatch para a propriedade configurada ApplicationName . Se a fonte de dados der suporte a recursos de pesquisa adicionais, como caracteres curinga, você poderá fornecer recursos de pesquisa mais abrangentes para endereços de email.

Os resultados retornados por FindUsersByEmail são restritos pelos pageIndex parâmetros e pageSize . O pageSize parâmetro identifica o número de MembershipUser objetos a serem retornados na MembershipUserCollection coleção. O pageIndex parâmetro identifica qual página de resultados retornar onde 0 identifica a primeira página. O totalRecords parâmetro é um out parâmetro definido como o número total de usuários de associação que corresponderam ao emailToMatch valor. Por exemplo, se 13 usuários foram encontrados onde emailToMatch correspondeu parte ou todo o endereço de email, e o pageIndex valor era 1 com um pageSize de 5, o MembershipUserCollection conteria o sexto até o décimo usuário retornado. totalRecords seria definido como 13.

Confira também

• Implementando um provedor de associação
• Introdução à associação ASP.NET