ProfileProvider.FindProfilesByUserName Método

Referencia

Definición

Espacio de nombres:: System.Web.Profile

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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 How to: Build and Run the Profile Provider Example.

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

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 a los décimo perfiles inactivos devueltos. El totalRecords parámetro se establecería en 13.

Se aplica a