ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию всех пользователей, хранящихся в источнике данных 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 MembershipUserCollectionПараметры
- pageIndex
- Int32
Индекс возвращаемой страницы результатов.
pageIndex отсчитывается, начиная с нуля.
- pageSize
- Int32
Размер возвращаемой страницы результатов.
- totalRecords
- Int32
При возврате этого метода содержит общее количество записей, возвращаемых в коллекции. Этот параметр передается без инициализации.
Возвращаемое значение
pageSize
MembershipUser Содержащий MembershipUserCollection экземпляры, начинающиеся на странице, указанной в параметре pageIndex.
Исключения
Метод GetAllUsers(Int32, Int32, Int32) вызывается перед ActiveDirectoryMembershipProvider инициализацией экземпляра.
pageIndex меньше 0.
-или
pageSize меньше 1.
–или–
pageSize умножено на pageIndex, плюс pageSize, минус 1 больше , чем Int32.MaxValue.
Свойство EnableSearchMethods является false.
Комментарии
Этот метод вызывается классом Membership для получения сведений о пользователе из хранилища данных Active Directory, указанного в файле конфигурации приложения ASP.NET.
Результаты, GetAllUsers возвращаемые методом, ограничены pageIndex параметрами и pageSize параметрами. Параметр pageSize задает максимальное количество экземпляров MembershipUser , возвращаемых в коллекцию MembershipUserCollection . Параметр pageIndex указывает, какая страница результатов возвращается, где 0 (ноль) указывает первую страницу.
Параметр totalRecords — это out параметр, который имеет общее количество соответствующих пользователей членства, найденных в хранилище данных Active Directory. Например, если для настроенного хранилища данных имеется 13 пользователей, а pageIndex значение равно 1 с la pageSize 5, MembershipUserCollection возвращенное значение будет содержать шестое по десятый. Параметр totalRecords будет иметь значение 13.
Вы можете управлять разрешением поиска пользователей, задав EnableSearchMethods свойство в файле конфигурации приложения с помощью enableSearchMethods атрибута элемента членства (ASP.NET settings Schema).
EnableSearchMethods Установка свойства для falseGetAllUsers вызова метода исключенияNotSupportedException.
Поставщик использует поиск поддерев, начиная с точки поиска, указанной в строке подключения. Дополнительные сведения о строках подключения см. в ActiveDirectoryMembershipProvider разделе класса.
Рекомендуется не включать поиск в рабочих системах, пока вы не подтвердите, что поисковые запросы, ActiveDirectoryMembershipProvider выданные классом, не негативно влияют на производительность сервера каталогов. ActiveDirectoryMembershipProvider Так как класс предназначен для веб-среды без отслеживания состояния, он не может использовать оптимизации разбиения на страницы, предоставляемые базовыми System.DirectoryServices API. Это означает, что операции разбиения по страницам во время поиска по большим каталогам очень дороги и следует избегать. Операции поиска всегда выдаются на сервере каталогов, настроенном в строке подключения, или автоматически выбранный сервер в случае строки подключения, указывающей на домен. Поставщик не использует глобальный каталог для своих методов поиска.
