Compartilhar via


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

Definição

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

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.

Aplica-se a

Confira também