Partager via


MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Méthode

Définition

Obtient une collection d'utilisateurs d'appartenance dont le nom d'utilisateur correspond au nom spécifié.

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Paramètres

usernameToMatch
String

Nom d'utilisateur à rechercher.

pageIndex
Int32

Index de la page de résultats à retourner. pageIndex est de base zéro.

pageSize
Int32

Taille de la page de résultats à retourner.

totalRecords
Int32

Nombre total d’utilisateurs correspondants.

Retours

Collection MembershipUserCollection qui contient une page d’objets pageSizeMembershipUser commençant à la page spécifiée par pageIndex.

Exemples

Pour obtenir un exemple d’implémentation MembershipProvider , consultez Implémentation d’un fournisseur de profil.

Remarques

FindUsersByName retourne une liste d’utilisateurs d’appartenance dont le nom d’utilisateur correspond à celui fourni usernameToMatch pour la propriété configurée ApplicationName . 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 sont limités par FindUsersByName les pageIndex paramètres et pageSize . Le pageSize paramètre identifie le nombre d’objets MembershipUser à retourner dans la MembershipUserCollection collection. Le pageIndex paramètre identifie la page de résultats à retourner, où 0 identifie la première page. Le totalRecords paramètre est un out paramètre défini sur le nombre total d’utilisateurs d’appartenance correspondant à la usernameToMatch valeur. Par exemple, si 13 utilisateurs ont été trouvés là où usernameToMatch correspondait une partie ou le nom d’utilisateur entier, et que la pageIndex valeur était 1 avec un pageSize de 5, le MembershipUserCollection contiendrait les sixième à dixième utilisateurs retournés. totalRecords est défini sur 13.

S’applique à

Voir aussi