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’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.