ActiveDirectoryMembershipProvider.GetAllUsers(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 de tous les utilisateurs stockés dans une source de données Active Directory.
public:
override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public override System.Web.Security.MembershipUserCollection GetAllUsers(int pageIndex, int pageSize, out int totalRecords);override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollectionPublic Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParamètres
- pageIndex
- Int32
Index de la page des résultats à retourner.
pageIndex est basé sur zéro.
- pageSize
- Int32
Taille de la page des résultats à retourner.
- totalRecords
- Int32
Lorsque cette méthode est retournée, contient le nombre total d’enregistrements retournés dans la collection. Ce paramètre est passé non initialisé.
Retours
Instance MembershipUserCollection contenant commençant pageSizeMembershipUser à la page spécifiée par pageIndex.
Exceptions
La GetAllUsers(Int32, Int32, Int32) méthode est appelée avant l’initialisation de l’instance ActiveDirectoryMembershipProvider .
pageIndex est inférieur à 0.
-Ou
pageSize est inférieur à 1.
- ou -
pageSize multiplié par pageIndex, plus pageSize, moins 1 est supérieur à Int32.MaxValue.
La EnableSearchMethods propriété est false.
Remarques
Cette méthode est appelée par la Membership classe pour récupérer des informations utilisateur à partir du magasin de données Active Directory spécifié dans le fichier de configuration de l’application ASP.NET.
Les résultats retournés par la GetAllUsers méthode sont limités par les paramètres et pageSize les pageIndex paramètres. Le pageSize paramètre spécifie le nombre maximal d’instances MembershipUser à retourner dans la MembershipUserCollection collection. Le pageIndex paramètre spécifie la page des résultats à retourner, où 0 (zéro) indique la première page.
Le totalRecords paramètre est un out paramètre défini sur le nombre total d’utilisateurs d’appartenance correspondants trouvés dans le magasin de données Active Directory. Par exemple, s’il existe 13 utilisateurs pour le magasin de données configuré et que la pageIndex valeur était 1 avec pageSize la 5, le MembershipUserCollection retour contiendrait le sixième au dixième utilisateur. Le totalRecords paramètre est défini sur 13.
Vous pouvez contrôler s’il faut autoriser la recherche d’utilisateurs en définissant la EnableSearchMethods propriété dans le fichier de configuration de l’application à l’aide de l’attribut enableSearchMethods de l’élément membership (ASP.NET Settings Schema). La définition de la EnableSearchMethods propriété pour false provoquer la levée d’une NotSupportedException exception par la GetAllUsers méthode.
Le fournisseur utilise une recherche de sous-arborescence à partir du point de recherche spécifié dans la chaîne de connexion. Pour plus d’informations sur les chaînes de connexion, consultez la ActiveDirectoryMembershipProvider rubrique de classe.
Nous vous recommandons de ne pas activer la recherche sur les systèmes de production tant que vous n’avez pas confirmé que les requêtes de recherche émises par la ActiveDirectoryMembershipProvider classe n’affectent pas les performances de votre serveur d’annuaires. Étant donné que la ActiveDirectoryMembershipProvider classe est conçue pour un environnement Web sans état, elle ne peut pas utiliser les optimisations de pagination exposées par les API sous-jacentes System.DirectoryServices . Cela signifie que les opérations de pagination pendant les recherches sur les répertoires volumineux sont très coûteuses et doivent être évitées. Les opérations de recherche sont toujours émises sur le serveur d’annuaire configuré dans la chaîne de connexion, ou un serveur sélectionné automatiquement dans le cas d’une chaîne de connexion pointant vers un domaine. Le fournisseur n’utilise pas de catalogue global pour ses méthodes de recherche.
