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

Référence

Définition

Espace de noms:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.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.

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

MembershipUserCollection

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 à

Partager via