Partilhar via


ProfileProvider.FindProfilesByUserName Método

Definição

Quando substituído em uma classe derivada, recupera informações de perfil para perfis em que o nome de usuário corresponde aos nomes de usuário 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 valores de ProfileAuthenticationOption, especificando se anônimo, autenticado ou ambos os tipos de perfis são retornados.

usernameToMatch
String

O nome de usuário a ser pesquisado.

pageIndex
Int32

O índice da página de resultados a serem retornados.

pageSize
Int32

O tamanho da página de resultados a ser retornada.

totalRecords
Int32

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

Retornos

Um ProfileInfoCollection que contém informações de perfil de usuário para perfis em que o nome de usuário corresponde ao parâmetro usernameToMatch fornecido.

Exemplos

O exemplo de código a seguir mostra a assinatura do método para uma implementação do FindProfilesByUserName método . Para obter um exemplo de implementação completa ProfileProvider , consulte Como compilar 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

Comentários

O FindProfilesByUserName método retorna uma lista de informações de perfil para perfis nos quais o nome de usuário corresponde ao parâmetro fornecido usernameToMatch . Somente os dados do applicationName especificado no arquivo de configuração são retornados. O authenticationOption parâmetro especifica se somente perfis anônimos, somente perfis autenticados ou todos os perfis são pesquisados.

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 FindProfilesByUserName são restritos pelos pageIndex parâmetros e pageSize . O pageSize parâmetro identifica o número máximo de ProfileInfo objetos a serem retornados no ProfileInfoCollection. O pageIndex parâmetro identifica qual página de resultados retornar, em que zero identifica a primeira página. O totalRecords parâmetro é um out parâmetro definido como o número total de perfis de usuário inativos para o configurado applicationName, com base nos authenticationOption parâmetros e userInactiveSinceDate . Por exemplo, se houver 13 usuários para o configurado applicationNamee o pageIndex valor for 1 com um pageSize de 5, o ProfileInfoCollection retornado conterá o sexto ao décimo perfis inativos retornados. O totalRecords parâmetro seria definido como 13.

Aplica-se a

Confira também