ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) 메서드

정의

네임스페이스:

System.Web.Security

어셈블리:

System.Web.dll

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는 0부터 시작합니다.

pageSize

Int32

반환할 결과 페이지의 크기입니다.

totalRecords

Int32

이 메서드가 반환될 때, 컬렉션에 반환된 전체 레코드 수가 포함됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환

MembershipUserCollection

pageSize에 지정된 페이지에서 시작하는 pageIndexMembershipUserCollection 인스턴스가 포함된 MembershipUser입니다.

예외

InvalidOperationException

GetAllUsers(Int32, Int32, Int32) 인스턴스가 초기화되기 전에 ActiveDirectoryMembershipProvider 메서드가 호출된 경우

ArgumentException

pageIndex 가 0보다 작습니다.

-또는-

pageSize가 1보다 작습니다.

또는

pageSize 를 곱한 pageIndex다음 pageSize, 을 뺀 값 1이 Int32.MaxValue보다 큽 있습니다.

NotSupportedException

EnableSearchMethods 속성은 false입니다.

설명

이 메서드는 Membership ASP.NET 애플리케이션의 구성 파일에 지정 된 Active Directory 데이터 저장소에서 사용자 정보를 검색 하는 클래스입니다.

메서드에서 반환된 GetAllUsers 결과는 및 pageSize 매개 변수에 pageIndex 의해 제한됩니다. 매개 변수는 pageSize 컬렉션에서 MembershipUserCollection 반환할 최대 인스턴스 수를 MembershipUser 지정합니다. 매개 변수는 pageIndex 반환할 결과의 페이지를 지정합니다. 여기서 0은 첫 번째 페이지를 나타냅니다.

totalRecords 매개 변수는 out Active Directory 데이터 저장소에 있는 일치하는 멤버 자격 사용자의 총 수로 설정된 매개 변수입니다. 예를 들어 구성된 데이터 저장소에 대한 사용자가 13명이고 pageIndex 값이 1이고 la pageSize 가 5인 MembershipUserCollection 경우 반환된 에는 여섯 번째부터 10번째까지의 사용자가 포함됩니다. totalRecords 13 매개 변수를 설정 합니다.

설정 하 여 사용자에 대 한 검색을 허용할지 여부를 제어할 수 있습니다는 EnableSearchMethods 를 사용 하 여 애플리케이션의 구성에서 속성 파일를 enableSearchMethods 특성을 membership 요소 (ASP.NET 설정 스키마) 요소. 속성을 로 EnableSearchMethodsfalse 설정하면 메서드가 GetAllUsers 예외를 throw합니다 NotSupportedException .

공급자는 연결 문자열에 지정된 검색 지점에서 시작하는 하위 트리 검색을 사용합니다. 연결 문자열에 ActiveDirectoryMembershipProvider 대한 자세한 내용은 클래스 항목을 참조하세요.

클래스에서 발급 ActiveDirectoryMembershipProvider 한 검색 쿼리가 디렉터리 서버의 성능에 부정적인 영향을 미치지 않는지 확인할 때까지 프로덕션 시스템에서 검색을 사용하도록 설정하지 않는 것이 좋습니다. 클래스는 ActiveDirectoryMembershipProvider 상태 비저장 웹 환경을 위해 설계되었으므로 기본 API에서 노출하는 페이징 최적화를 System.DirectoryServices 사용할 수 없습니다. 즉, 큰 디렉터리에 대한 검색 중에 페이징 작업은 매우 비용이 많이 들며 피해야 합니다. 검색 작업은 항상 연결 문자열에 구성된 디렉터리 서버 또는 도메인을 가리키는 연결 문자열의 경우 자동으로 선택된 서버에 대해 실행됩니다. 공급자는 검색 방법에 전역 카탈로그를 사용하지 않습니다.

추가 정보

• ASP.NET 멤버 자격 소개