Compartir a través de

ProfileProvider.FindProfilesByUserName 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 el nombre de usuario coincide con los nombres de usuario especificados.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, 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.

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

ProfileInfoCollection que contiene información de aquellos perfiles de usuario 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 FindProfilesByUserName 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 FindProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

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

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Comentarios

El FindProfilesByUserName método devuelve una lista de información de perfil 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.

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