ProfileProvider.FindInactiveProfilesByUserName Método

Definición

Espacio de nombres:
System.Web.Profile
Ensamblado:
System.Web.dll

Cuando se reemplaza en una clase derivada, recupera la información de perfil de los perfiles en los que se produjo la última fecha de actividad en o antes de la fecha especificada 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 ProfileAuthenticationOption valores, que especifica si se devuelven anónimos, autenticados o ambos tipos de perfiles.

usernameToMatch
String

Nombre de usuario que se va a buscar.

userInactiveSinceDate
DateTime

DateTime que identifica qué perfiles de usuario se consideran inactivos. Si el LastActivityDate valor de un perfil de usuario se produce en o antes de esta fecha y hora, 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 devuelve, contiene el número total de perfiles.

Devoluciones

ProfileInfoCollection

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

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 la información de perfil de los perfiles de usuario no usados 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 a los décimo perfiles inactivos devueltos. El totalRecords parámetro se establecería en 13.

Se aplica a

Consulte también