ProfileProvider.FindProfilesByUserName Método

Definição

Espaço de Nomes:
System.Web.Profile
Assemblagem:
System.Web.dll

Quando sobreposto numa classe derivada, recupera informação de perfil para perfis em que o nome de utilizador corresponde aos nomes de utilizador especificados.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName(System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

Parâmetros

authenticationOption
ProfileAuthenticationOption

Um dos ProfileAuthenticationOption valores, que especifica se é anónimo, autenticado ou ambos os tipos de perfis, é devolvido.

usernameToMatch
String

O nome de utilizador a procurar.

pageIndex
Int32

O índice da página de resultados para devolver.

pageSize
Int32

O tamanho da página de resultados para devolver.

totalRecords
Int32

Quando este método retorna, contém o número total de perfis.

Devoluções

ProfileInfoCollection

A contendo informações de perfil de utilizador para perfis onde o nome de utilizador corresponde ProfileInfoCollection ao parâmetro fornecido.usernameToMatch

Exemplos

O seguinte exemplo de código mostra a assinatura do método para uma implementação do FindProfilesByUserName método. Para um exemplo de implementação completa ProfileProvider , veja Como: Construir e Executar o Exemplo do Provedor de Perfil.

public override ProfileInfoCollection FindProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

Public Overrides Function FindProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Observações

O FindProfilesByUserName método devolve uma lista de informações de perfil para perfis em que o nome de utilizador corresponde ao parâmetro fornecido.usernameToMatch Apenas os dados especificados applicationName no ficheiro de configuração são devolvidos. O authenticationOption parâmetro especifica se apenas perfis anónimos, apenas perfis autenticados ou todos os perfis são pesquisados.

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 FindProfilesByUserName são limitados pelos pageIndex parâmetros e.pageSize O pageSize parâmetro identifica o número máximo de ProfileInfo objetos a devolver no ProfileInfoCollection. O pageIndex parâmetro identifica qual página de resultados devolver, onde zero identifica a primeira página. O totalRecords parâmetro é um out parâmetro definido para o número total de perfis de utilizador inativos para o configurado applicationName, com base nos authenticationOption parâmetros e userInactiveSinceDate . Por exemplo, se houver 13 utilizadores para o configurado applicationName, e o pageIndex valor for 1 com a pageSize de 5, os ProfileInfoCollection retornados conterão os perfis inativos do sexto ao décimo devolvidos. O totalRecords parâmetro seria definido para 13.

Aplica-se a

Ver também