다음을 통해 공유


DirectorySearcher 클래스

정의

Active Directory 도메인 서비스에 대한 쿼리를 수행합니다.

public ref class DirectorySearcher : System::ComponentModel::Component
public class DirectorySearcher : System.ComponentModel.Component
[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Component
type DirectorySearcher = class
    inherit Component
[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
    inherit Component
Public Class DirectorySearcher
Inherits Component
상속
DirectorySearcher
특성

설명

개체를 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

ComponentISite를 가져오거나 설정합니다.

(다음에서 상속됨 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)

적용 대상

추가 정보