ProfileProvider.FindProfilesByUserName Méthode

Référence

Définition

Espace de noms:: System.Web.Profile

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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 à