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

Referência

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.dll

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 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.

Aplica-se a

Compartilhar via