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' MembershipProvider implémentation, consultez implémentation d’un fournisseur de profils.

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 FindUsersByName sont limités par les pageIndex pageSize paramètres et. Le pageSize paramètre identifie le nombre d' MembershipUser objets à 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 qui correspondent à la usernameToMatch valeur. Par exemple, si treize utilisateurs ont trouvé usernameToMatch une partie de ou le nom d’utilisateur complet, et que la pageIndex valeur était 1 avec pageSize 5, alors le MembershipUserCollection contient le sixième au dixième utilisateur retourné. totalRecords la valeur est 13.

S’applique à

Share via