Partager via


ProfileProvider.FindProfilesByUserName Méthode

Définition

En cas de substitution dans une classe dérivée, récupère des informations de profil pour les profils dans lesquels le nom d'utilisateur correspond aux noms d'utilisateurs spécifiés.

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

Paramètres

authenticationOption
ProfileAuthenticationOption

Une des valeurs ProfileAuthenticationOption spécifiant si le type de profil anonyme, authentifié, ou les deux sont retournés.

usernameToMatch
String

Nom d'utilisateur à rechercher.

pageIndex
Int32

Index de la page de résultats à retourner.

pageSize
Int32

Taille de la page de résultats à retourner.

totalRecords
Int32

Lorsque cette méthode est retournée, contient le nombre total de profils.

Retours

ProfileInfoCollection contenant des informations sur les profils utilisateur pour les profils où le nom d'utilisateur correspond au paramètre usernameToMatch fourni.

Exemples

L’exemple de code suivant montre la signature de méthode pour une implémentation de la FindProfilesByUserName méthode . Pour obtenir un exemple d’implémentation complète ProfileProvider , consultez Guide pratique pour générer et exécuter l’exemple de fournisseur de profils.

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

Remarques

La FindProfilesByUserName méthode retourne une liste d’informations de profil pour les profils dans lesquels le nom d’utilisateur correspond au paramètre fourni usernameToMatch . Seules les données pour le applicationName spécifié dans le fichier de configuration sont retournées. Le authenticationOption paramètre spécifie si seuls les profils anonymes, seuls les profils authentifiés ou tous les profils font l’objet d’une recherche.

Si votre source de données prend en charge des fonctionnalités de recherche supplémentaires, telles que des caractères génériques, vous pouvez fournir des fonctionnalités de recherche plus étendues pour les noms d’utilisateur.

Les résultats retournés par FindProfilesByUserName sont limités par les pageIndex paramètres et pageSize . Le pageSize paramètre identifie le nombre maximal d’objets ProfileInfo à retourner dans le ProfileInfoCollection. Le pageIndex paramètre identifie la page de résultats à retourner, où zéro identifie la première page. Le totalRecords paramètre est un out paramètre qui est défini sur le nombre total de profils utilisateur inactifs pour le configuré applicationName, en fonction des authenticationOption paramètres et userInactiveSinceDate . Par exemple, s’il y a 13 utilisateurs pour le configuré applicationNameet que la pageIndex valeur est 1 avec un pageSize de 5, le ProfileInfoCollection retourné contient le sixième au dixième profils inactifs retournés. Le totalRecords paramètre est défini sur 13.

S’applique à

Voir aussi