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.MembershipUserCollection
Public Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
- pageIndex
- Int32
Индекс страницы возвращаемых результатов. Индекс pageIndex
отсчитывается от нуля.
- pageSize
- Int32
Размер возвращаемой страницы результатов.
- totalRecords
- Int32
По окончании метод возвращает общее число записей, возвращенных в коллекции. Этот параметр передается неинициализированным.
Объект MembershipUserCollection, содержащий экземпляры pageSize
MembershipUser, начиная со страницы, определенной параметром 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
атрибута элемента 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 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: