MembershipProvider.FindUsersByName(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 em que o nome de usuário contém o nome de usuário especificado para corresponder.

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

O nome de usuário 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

FindUsersByName retorna uma lista de usuários de associação em que o nome de usuário corresponde ao fornecido usernameToMatch 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 nomes de usuário.

Os resultados retornados por FindUsersByName 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, em que 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 usernameToMatch valor. Por exemplo, se 13 usuários foram encontrados onde usernameToMatch a parte correspondente ou o nome de usuário inteiro 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