DirectorySearcher 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Active Directory 도메인 서비스에 대한 쿼리를 수행합니다.
public ref class DirectorySearcher : System::ComponentModel::Componentpublic class DirectorySearcher : System.ComponentModel.Component[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Componenttype DirectorySearcher = class
inherit Component[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
inherit ComponentPublic Class DirectorySearcher
Inherits Component- 상속
- 특성
설명
개체를 DirectorySearcher 사용하여 LDAP(Lightweight Directory Access Protocol)를 사용하여 Active Directory Domain Services 계층 구조에 대한 쿼리를 검색하고 수행합니다. LDAP는 디렉터리 검색을 지원하는 유일한 시스템 제공 ADSI(Active Directory Service Interfaces) 공급자입니다. 관리자는 계층 구조에 있는 개체를 만들고, 변경하고, 삭제할 수 있습니다. 자세한 내용은 Using System.DirectoryServices(System.DirectoryServices 사용)를 참조하세요.
인스턴스 DirectorySearcher를 만들 때 검색할 루트와 검색할 속성의 선택적 목록을 지정합니다. 속성을 SearchRoot 사용하면 다음 작업을 수행하도록 추가 속성을 설정할 수 있습니다.
로컬 컴퓨터에서 검색 결과를 캐시합니다. CacheResults 로컬 컴퓨터에 디렉터리 정보를 저장하려면 속성을
true로 설정합니다. 이 로컬 캐시에 대한 업데이트가 수행되고 메서드가 호출된 경우에만 Active Directory Domain Services에 DirectoryEntry.CommitChanges 커밋됩니다.속성을 사용하여 검색할 시간을 지정합니다 ServerTimeLimit .
특성 이름만 검색합니다. PropertyNamesOnly 값을 할당한 특성의 이름만 검색하려면 속성을
true로 설정합니다.페이징된 검색을 수행합니다. 설정 된 PageSize 페이징된 검색에 반환 되는 개체의 최대 수를 지정 하는 속성입니다. 페이징 검색을 수행하지 않으려면 속성을 기본값인 0으로 설정합니다 PageSize .
속성을 사용하여 SizeLimit 반환할 최대 항목 수를 지정합니다. 속성을 기본값인 SizeLimit 0으로 설정하면 서버에서 결정한 기본값은 1000개 항목입니다.
참고
반환된 최대 항목 수와 시간 제한이 서버에 설정된 제한을 초과하면 서버 설정이 구성 요소 설정을 재정의합니다.
DirectorySearcher 클래스의 인스턴스에 대한 초기 속성 값 목록은 DirectorySearcher() 생성자를 참조하십시오.
참고
이 클래스를 사용하기 전에 Active Directory Domain Services에 대한 일반적인 이해가 있다고 가정합니다. 자세한 내용은 개요를 참조하세요 System.DirectoryServices .
생성자
| DirectorySearcher() |
기본값을 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(DirectoryEntry) |
지정된 검색 루트를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(DirectoryEntry, String) |
지정된 검색 루트와 검색 필터를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(DirectoryEntry, String, String[]) |
지정된 검색 루트, 검색 필터 및 검색할 속성을 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(DirectoryEntry, String, String[], SearchScope) |
지정된 검색 루트, 검색 필터, 검색할 속성 및 검색 범위를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(String) |
지정된 검색 필터를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(String, String[]) |
지정된 검색 필터와 검색할 속성을 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
| DirectorySearcher(String, String[], SearchScope) |
지정된 검색 필터, 검색할 속성 및 검색 범위를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다. |
속성
| Asynchronous |
검색이 비동기적으로 수행되는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| AttributeScopeQuery |
검색할 고유 이름 특성의 LDAP 표시 이름을 가져오거나 설정합니다. 이 형식의 검색에는 특성을 하나만 사용할 수 있습니다. |
| CacheResults |
클라이언트 컴퓨터에 결과를 캐시할 것인지 여부를 나타내는 값을 가져오거나 설정합니다. |
| CanRaiseEvents |
구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
| ClientTimeout |
서버에서 결과가 반환될 때까지 클라이언트가 기다리는 최대 시간을 가져오거나 설정합니다. 이 시간 내에 서버 응답이 없으면 검색이 중단되고 결과가 반환되지 않습니다. |
| Container |
IContainer을 포함하는 Component를 가져옵니다. (다음에서 상속됨 Component) |
| DerefAlias |
검색 과정에서 검색한 개체의 별칭을 확인하는 방법을 나타내는 값을 가져오거나 설정합니다. |
| DesignMode |
Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component) |
| DirectorySynchronization |
검색에 사용할 디렉터리 동기화 컨트롤을 나타내는 개체를 가져오거나 설정합니다. |
| Events |
이 Component에 연결된 이벤트 처리기의 목록을 가져옵니다. (다음에서 상속됨 Component) |
| ExtendedDN |
고유 이름의 형식을 나타내는 값을 가져오거나 설정합니다. |
| Filter |
LDAP(Lightweight Directory Access Protocol) 형식의 필터 문자열을 나타내는 값을 가져오거나 설정합니다. |
| PageSize |
페이지 단위 검색의 페이지 크기를 나타내는 값을 가져오거나 설정합니다. |
| PropertiesToLoad |
검색 과정에서 검색할 속성의 목록을 나타내는 값을 가져옵니다. |
| PropertyNamesOnly |
값이 할당된 특성의 이름만 검색할 것인지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ReferralChasing |
조회를 추적하는 방법을 나타내는 값을 가져오거나 설정합니다. |
| SearchRoot |
Active Directory 도메인 서비스 계층 구조에서 검색이 시작되는 노드를 나타내는 값을 가져오거나 설정합니다. |
| SearchScope |
서버에서 관찰하는 검색 범위를 나타내는 값을 가져오거나 설정합니다. |
| SecurityMasks |
검색을 수행하여 반환할 지정된 특성의 보안 액세스 정보를 나타내는 값을 가져오거나 설정합니다. |
| ServerPageTimeLimit |
서버에서 개별 결과 페이지를 검색할 최대 시간을 나타내는 값을 가져오거나 설정합니다. 이 시간은 전체 검색에 대한 시간 제한과 같지 않습니다. |
| ServerTimeLimit |
ServerTimeLimit 속성은 서버에서 검색을 수행하는 데 걸리는 최대 시간을 나타내는 값을 가져오거나 설정합니다. 시간 제한에 도달하면 그때까지 검색한 엔트리만 반환됩니다. |
| Site |
Component의 ISite를 가져오거나 설정합니다. (다음에서 상속됨 Component) |
| SizeLimit |
검색을 수행했을 때 서버에서 반환하는 최대 개체 수를 나타내는 값을 가져오거나 설정합니다. |
| Sort |
결과가 정렬되는 속성을 나타내는 값을 가져오거나 설정합니다. |
| Tombstone |
검색을 수행하여 검색 필터와 일치하는 삭제된 개체도 반환할지 여부를 나타내는 값을 가져오거나 설정합니다. |
| VirtualListView |
검색에 대한 가상 목록 보기 옵션을 나타내는 값을 가져오거나 설정합니다. |
메서드
| CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| Dispose() |
Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component) |
| Dispose(Boolean) |
DirectorySearcher 개체에서 사용하는 관리되는 리소스를 해제하고 관리되지 않는 리소스를 선택적으로 해제합니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
| FindAll() |
검색을 실행하고 검색한 엔트리 컬렉션을 반환합니다. |
| FindOne() |
검색을 실행하고 첫 번째로 검색한 엔트리만 반환합니다. |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetLifetimeService() |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject) |
| GetService(Type) |
Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다. (다음에서 상속됨 Component) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| InitializeLifetimeService() |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject) |
| MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| MemberwiseClone(Boolean) |
현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| ToString() |
Component의 이름이 포함된 String을 반환합니다(있는 경우). 이 메서드는 재정의할 수 없습니다. (다음에서 상속됨 Component) |
이벤트
| Disposed |
Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component) |
적용 대상
추가 정보
.NET