ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Метод

Определение

Возвращает коллекцию всех пользователей, хранимых в источнике данных Active Directory.

public override System.Web.Security.MembershipUserCollection GetAllUsers (int pageIndex, int pageSize, out int totalRecords);

Параметры

pageIndex
Int32

Индекс страницы возвращаемых результатов. Индекс pageIndex отсчитывается от нуля.

pageSize
Int32

Размер возвращаемой страницы результатов.

totalRecords
Int32

По окончании метод возвращает общее число записей, возвращенных в коллекции. Этот параметр передается неинициализированным.

Возвращаемое значение

Объект MembershipUserCollection, содержащий экземпляры pageSizeMembershipUser, начиная со страницы, определенной параметром pageIndex.

Исключения

Метод GetAllUsers(Int32, Int32, Int32) вызывается до инициализации экземпляра ActiveDirectoryMembershipProvider.

Значение параметраpageIndex меньше 0.

или

Значение параметра pageSize меньше 1.

-или-

pageSize умножено на pageIndex, плюс pageSize, минус 1 больше , чем Int32.MaxValue.

Значение свойства EnableSearchMethodsfalse.

Комментарии

Этот метод вызывается классом для получения сведений 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 атрибута элемента membership Element (ASP.NET Settings Schema). EnableSearchMethods Если задать для свойства значение false , метод вызовет GetAllUsersNotSupportedException исключение.

Поставщик использует поиск по поддереву, начиная с точки поиска, указанной в строке подключения. ActiveDirectoryMembershipProvider Дополнительные сведения о строках подключения см. в разделе о классах.

Рекомендуется не включать поиск в рабочих системах, пока не будет подтверждено, что поисковые запросы, выданные классом ActiveDirectoryMembershipProvider , не влияют на производительность сервера каталогов. ActiveDirectoryMembershipProvider Так как класс предназначен для веб-среды без отслеживания состояния, он не может использовать оптимизации разбиения по страницам, предоставляемые базовыми System.DirectoryServices API. Это означает, что операции разбиения по страницам во время поиска в больших каталогах являются очень дорогостоящими и их следует избегать. Операции поиска всегда выполняются для сервера каталогов, настроенного в строке подключения, или на автоматически выбранном сервере в случае строки подключения, указывающей на домен. Поставщик не использует глобальный каталог для своих методов поиска.

Применяется к

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

См. также раздел