ProfileProvider.FindInactiveProfilesByUserName Método

Definição

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

Quando sobrescrito numa classe derivada, recupera informação de perfil para perfis em que a data da última atividade ocorreu na data especificada ou antes da data especificada e o nome de utilizador corresponde ao nome de utilizador 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 ProfileAuthenticationOption valores, que especifica se é anónimo, autenticado ou ambos os tipos de perfis, é devolvido.

usernameToMatch
String

O nome de utilizador a procurar.

userInactiveSinceDate
DateTime

A DateTime que identifica quais os perfis de utilizador considerados inativos. Se o LastActivityDate valor de um perfil de utilizador ocorrer nessa data e hora, o perfil é considerado inativo.

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 inativos 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 FindInactiveProfilesByUserName método. Para um exemplo de implementação completa ProfileProvider , veja Como: Construir 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

Observações

O FindInactiveProfilesByUserName método é usado para recuperar informação de perfil de perfis de utilizador não utilizados 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. Dos perfis pesquisados, qualquer perfil com a LastActivityDate que ocorra em ou antes do valor do parâmetro especificado userInactiveSinceDate é devolvido.

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