MembershipProvider.FindUsersByEmail(String, Int32, Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 pageSize
MembershipUser 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.