ProfileProvider.FindInactiveProfilesByUserName Método

  • Referencia

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 Cómo: Compilar y ejecutar el ejemplo de proveedor de perfiles.

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 la información de perfil de los perfiles de usuario no utilizados para los perfiles en los que el nombre de usuario coincide con el parámetro proporcionado usernameToMatch . Solo se devuelven los datos del 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 hasta el décimo perfil inactivo devuelto. El totalRecords parámetro se establecería en 13.

Se aplica a

Consulte también