MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma coleção de utilizadores de membros onde o nome de utilizador contém o nome de utilizador 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.MembershipUserCollectionPublic MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParâmetros
- usernameToMatch
- String
O nome de utilizador a procurar.
- pageIndex
- Int32
O índice da página de resultados para devolver.
pageIndex é baseado em zero.
- pageSize
- Int32
O tamanho da página de resultados para devolver.
- totalRecords
- Int32
O número total de utilizadores emparelhados.
Devoluções
Uma MembershipUserCollection coleção que contém uma página de pageSizeMembershipUser objetos começando na página especificada por pageIndex.
Exemplos
Para um exemplo de implementação MembershipProvider , veja Implementar um Fornecedor de Perfis.
Observações
FindUsersByName devolve uma lista de utilizadores de membros onde o nome de utilizador corresponde ao fornecido usernameToMatch para a propriedade configurada ApplicationName . Se a sua fonte de dados suportar capacidades adicionais de pesquisa, como caracteres curinga, pode fornecer capacidades de pesquisa mais extensas para nomes de utilizador.
Os resultados devolvidos por FindUsersByName são limitados pelos pageIndex parâmetros e.pageSize O pageSize parâmetro identifica o número de MembershipUser objetos a devolver na MembershipUserCollection coleção. O pageIndex parâmetro identifica qual página de resultados devolver, onde 0 identifica a primeira página. O totalRecords parâmetro é definido out para o número total de utilizadores de membros que corresponderam ao usernameToMatch valor. Por exemplo, se forem encontrados 13 utilizadores que usernameToMatch correspondiam a parte ou ao nome de utilizador completo, e o pageIndex valor fosse 1 com a pageSize de 5, então conteriam MembershipUserCollection o sexto ao décimo utilizador devolvido.
totalRecords seria definido para 13.
