ProfileProvider.FindInactiveProfilesByUserName Método

Referência

Definição

Namespace:: System.Web.Profile

Assembly:: System.Web.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.

Quando substituído em uma classe derivada, recupera informações de perfil para perfis nos quais a data da última atividade ocorreu na data especificada ou antes e o nome de usuário corresponde ao nome de usuário especificado.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindInactiveProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Profile.ProfileInfoCollection FindInactiveProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

abstract member FindInactiveProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollection

Public MustOverride Function FindInactiveProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, userInactiveSinceDate As DateTime, 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.

userInactiveSinceDate: DateTime

Um DateTime que identifica quais perfis de usuário são considerados inativos. Se o valor LastActivityDate de um perfil do usuário ocorrer nesta data e hora ou antes, o perfil será considerado inativo.

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

ProfileInfoCollection

Um ProfileInfoCollection que contém informações do perfil do usuário para perfis inativos 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 FindInactiveProfilesByUserName método. Para obter um exemplo de implementação completa ProfileProvider , consulte Como criar e executar o exemplo do provedor de perfil.

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

    return new ProfileInfoCollection();
}

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

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Comentários

O FindInactiveProfilesByUserName método é usado para recuperar informações de perfil para perfis de usuário não utilizados para perfis nos quais o nome de usuário corresponde ao parâmetro fornecido usernameToMatch . Somente os dados para os applicationName especificados no arquivo de configuração são retornados. O authenticationOption parâmetro especifica se somente perfis anônimos, apenas perfis autenticados ou todos os perfis são pesquisados. Dos perfis pesquisados, qualquer perfil com um LastActivityDate que ocorra ou antes do valor do parâmetro especificado userInactiveSinceDate ser retornado.

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 FindInactiveProfilesByUserName são restritos pelo parâmetro e pageSize pelos pageIndex parâmetros. 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, onde 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 configuradoapplicationName, com base no parâmetro e userInactiveSinceDate no authenticationOption parâmetro. 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 até o décimo perfis inativos retornados. O totalRecords parâmetro seria definido como 13.

Aplica-se a