ActiveDirectoryMembershipProvider.FindUsersByName 메서드

정의

네임스페이스:

System.Web.Security

어셈블리:

System.Web.dll

사용자 이름을 기준으로 Active Directory 데이터 저장소에서 사용자 컬렉션을 반환합니다.

public:
 override System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

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

override this.FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public Overrides Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

매개 변수

usernameToMatch

String

검색할 사용자 이름 또는 사용자 이름의 일부입니다.

pageIndex

Int32

반환할 결과 페이지의 인덱스입니다. pageIndex는 0부터 시작합니다.

pageSize

Int32

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

totalRecords

Int32

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

반환

MembershipUserCollection

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

예외

InvalidOperationException

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

ArgumentException

usernameToMatch이 비어 있거나 사용자 이름의 최대 길이(대개 256자)를 초과하는 경우

또는

usernameToMatch에 쉼표가 포함된 경우

또는

pageIndex 가 0보다 작습니다.

-또는-

pageSize가 1보다 작습니다.

또는

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

ArgumentNullException

usernameToMatch이(가) null인 경우

NotSupportedException

EnableSearchMethods 속성은 false입니다.

설명

메서드는 FindUsersByName 매개 변수와 일치하는 모든 사용자 이름에 대해 Active Directory 데이터 저장소의 사용자 레코드를 포함하는 인스턴스를 userNameToMatch 반환 MembershipUserCollection 합니다. 레코드는 사용자 이름으로 사전순으로 정렬되어 반환됩니다.

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

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

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

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

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

추가 정보

• ASP.NET 멤버 자격 소개