MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Méthode
Définition
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
Collection MembershipUserCollection qui contient une page d’objets pageSize
MembershipUser 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.