Compartilhar via


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

Definição

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

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.

Aplica-se a

Confira também