ProfileProvider.FindInactiveProfilesByUserName Método

Definición

Espacio de nombres:

System.Web.Profile

Ensamblado:

System.Web.dll

Cuando se reemplaza en una clase derivada, recupera información de aquellos perfiles en los que la fecha de última actividad es la fecha especificada o anterior y el nombre de usuario coincide con el nombre de usuario 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

Uno de los valores de la enumeración ProfileAuthenticationOption, que especifica si se devuelven perfiles anónimos, autenticados o de ambos tipos.

usernameToMatch

String

El nombre de usuario que se va a buscar.

userInactiveSinceDate

DateTime

Un objeto DateTime que identifica qué perfiles de usuario se consideran inactivos. Si el establecimiento del valor LastActivityDate de un perfil de usuario tiene lugar en esta fecha y hora o antes de la misma, el perfil se considera inactivo.

pageIndex

Int32

Índice de la página de resultados que se va a devolver.

pageSize

Int32

Tamaño de la página de resultados que se va a devolver.

totalRecords

Int32

Cuando este método finaliza, contiene el número total de perfiles.

Devoluciones

ProfileInfoCollection

Colección ProfileInfoCollection que contiene información de perfil de usuario de los perfiles inactivos en los que el nombre de usuario coincide con el parámetro usernameToMatch proporcionado.

Ejemplos

En el ejemplo de código siguiente se muestra la firma del método para una implementación del FindInactiveProfilesByUserName método . Para obtener un ejemplo de una implementación completa ProfileProvider , vea How to: Build and Run the Profile Provider Example.

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

Comentarios

El FindInactiveProfilesByUserName método se usa para recuperar información de perfil para perfiles de usuario sin usar para perfiles en los que el nombre de usuario coincide con el parámetro proporcionado usernameToMatch . Solo se devuelven los datos para el applicationName especificado en el archivo de configuración. El authenticationOption parámetro especifica si solo se buscan perfiles anónimos, solo perfiles autenticados o todos los perfiles. De los perfiles buscados, se devuelve cualquier perfil con un LastActivityDate que se produzca en o antes de que se devuelva el valor de parámetro especificado userInactiveSinceDate .

Si el origen de datos admite funcionalidades de búsqueda adicionales, como caracteres comodín, puede proporcionar funcionalidades de búsqueda más amplias para los nombres de usuario.

Los resultados devueltos por FindInactiveProfilesByUserName están restringidos por los pageIndex parámetros y pageSize . El pageSize parámetro identifica el número máximo de ProfileInfo objetos que se van a devolver en ProfileInfoCollection. El pageIndex parámetro identifica la página de resultados que se va a devolver, donde cero identifica la primera página. El totalRecords parámetro es un out parámetro que se establece en el número total de perfiles de usuario inactivos para el configurado applicationName, en función de los authenticationOption parámetros y userInactiveSinceDate . Por ejemplo, si hay 13 usuarios para el configurado applicationNamey el pageIndex valor es 1 con un pageSize de 5, el ProfileInfoCollection devuelto contendrá el sexto a los décimo perfiles inactivos devueltos. El totalRecords parámetro se establecería en 13.

Consulte también

• Implementación de un proveedor de perfiles
• Información general sobre las propiedades de perfil de ASP.NET