DirectorySearcher DirectorySearcher DirectorySearcher DirectorySearcher Class

정의

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

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

설명

사용 된 DirectorySearcher 개체를 검색 하 고 액세스 프로토콜 LDAP (Lightweight Directory)를 사용 하는 Active Directory Domain Services 계층 구조에 대 한 쿼리를 수행 합니다.Use a DirectorySearcher object to search and perform queries against an Active Directory Domain Services hierarchy using Lightweight Directory Access Protocol (LDAP). LDAP는 디렉터리 검색을 지 원하는 시스템 제공의 유일한 서비스 인터페이스 ADSI (Active Directory) 공급자입니다.LDAP is the only system-supplied Active Directory Service Interfaces (ADSI) provider that supports directory searching. 관리자 수 확인, 변경 및 계층에 있는 개체를 삭제 합니다.An administrator can make, alter, and delete objects that are found in the hierarchy. 자세한 내용은 System.DirectoryServices를 사용 하 여입니다.For more information, see Using System.DirectoryServices.

인스턴스를 만들면 DirectorySearcher, 루트를 검색 하려는 및 검색할 속성의 선택적 목록 지정 합니다.When you create an instance of DirectorySearcher, you specify the root you want to retrieve, and an optional list of properties to retrieve. SearchRoot 속성을 사용 하면 다음 태스크를 수행 하는 추가 속성을 설정할 수 있습니다.The SearchRoot property enables you to set additional properties to do the following tasks:

  • 로컬 컴퓨터의 검색 결과 캐시 합니다.Cache the search results on the local computer. 설정 된 CacheResults 속성을 true 로컬 컴퓨터에 디렉터리 정보를 저장 합니다.Set the CacheResults property to true to store directory information on the local computer. 업데이트 된이 로컬 캐시에 대 한 페이지와 Active Directory Domain Services에 커밋된 경우에만 DirectoryEntry.CommitChanges 메서드가 호출 됩니다.Updates are made to this local cache and committed to Active Directory Domain Services only when the DirectoryEntry.CommitChanges method is called.

  • 사용 하 여 시간을 검색 하려면 지정 된 ServerTimeLimit 속성입니다.Specify the length of time to search, using the ServerTimeLimit property.

  • 특성 이름만 검색 합니다.Retrieve attribute names only. 설정 된 PropertyNamesOnly 속성을 true 할당 된 값을 특성의 이름만 검색 하려면.Set the PropertyNamesOnly property to true to retrieve only the names of attributes to which values have been assigned.

  • 페이지 단위 검색을 수행 합니다.Perform a paged search. 설정 된 PageSize 페이지 단위 검색에서 반환 되는 개체의 최대 수를 지정 하는 속성입니다.Set the PageSize property to specify the maximum number of objects that are returned in a paged search. 페이지 단위 검색을 수행 하려면 설정의 PageSize 속성을 기본값 0.If you do not want to perform a paged search, set the PageSize property to its default of zero.

  • 사용 하 여 반환할 항목의 최대 수를 지정 합니다 SizeLimit 속성입니다.Specify the maximum number of entries to return, using the SizeLimit property. 설정 하는 경우는 SizeLimit 속성을 0으로 서버 기본값의 기본값은 1000 항목입니다.If you set the SizeLimit property to its default of zero, the server-determined default is 1000 entries.

참고

서버에 설정 된 한계를 초과 하는 반환 된 항목 및 시간 제한의 최대 수, 서버 설정을 구성 요소 설정을 재정의 합니다.If the maximum number of returned entries and time limits exceed the limitations that are set on the server, the server settings override the component settings.

DirectorySearcher 클래스의 인스턴스에 대한 초기 속성 값 목록은 DirectorySearcher() 생성자를 참조하십시오.For a list of initial property values for an instance of the DirectorySearcher class, see the DirectorySearcher() constructor.

참고

이 클래스를 사용 하기 전에 Active Directory Domain Services에 대 한 기본적인 지식이 있다고 가정 합니다.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. 자세한 내용은 참조는 System.DirectoryServices 개요.For more information, see the System.DirectoryServices overview.

생성자

DirectorySearcher() DirectorySearcher() DirectorySearcher() DirectorySearcher()

기본값을 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with default values.

DirectorySearcher(DirectoryEntry) DirectorySearcher(DirectoryEntry) DirectorySearcher(DirectoryEntry) DirectorySearcher(DirectoryEntry)

지정된 검색 루트를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class using the specified search root.

DirectorySearcher(DirectoryEntry, String) DirectorySearcher(DirectoryEntry, String) DirectorySearcher(DirectoryEntry, String) DirectorySearcher(DirectoryEntry, String)

지정된 검색 루트와 검색 필터를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with the specified search root and search filter.

DirectorySearcher(DirectoryEntry, String, String[]) DirectorySearcher(DirectoryEntry, String, String[]) DirectorySearcher(DirectoryEntry, String, String[]) DirectorySearcher(DirectoryEntry, String, String[])

지정된 검색 루트, 검색 필터 및 검색할 속성을 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with the specified search root, search filter, and properties to retrieve.

DirectorySearcher(DirectoryEntry, String, String[], SearchScope) DirectorySearcher(DirectoryEntry, String, String[], SearchScope) DirectorySearcher(DirectoryEntry, String, String[], SearchScope) DirectorySearcher(DirectoryEntry, String, String[], SearchScope)

지정된 검색 루트, 검색 필터, 검색할 속성 및 검색 범위를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with the specified search root, search filter, properties to retrieve, and search scope.

DirectorySearcher(String) DirectorySearcher(String) DirectorySearcher(String) DirectorySearcher(String)

지정된 검색 필터를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with the specified search filter.

DirectorySearcher(String, String[]) DirectorySearcher(String, String[]) DirectorySearcher(String, String[]) DirectorySearcher(String, String[])

지정된 검색 필터와 검색할 속성을 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with the specified search filter and properties to retrieve.

DirectorySearcher(String, String[], SearchScope) DirectorySearcher(String, String[], SearchScope) DirectorySearcher(String, String[], SearchScope) DirectorySearcher(String, String[], SearchScope)

지정된 검색 필터, 검색할 속성 및 검색 범위를 사용하여 DirectorySearcher 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectorySearcher class with the specified search filter, properties to retrieve, and search scope.

속성

Asynchronous Asynchronous Asynchronous Asynchronous

검색이 비동기적으로 수행되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates if the search is performed asynchronously.

AttributeScopeQuery AttributeScopeQuery AttributeScopeQuery AttributeScopeQuery

검색할 고유 이름 특성의 LDAP 표시 이름을 가져오거나 설정합니다.Gets or sets the LDAP display name of the distinguished name attribute to search in. 이 형식의 검색에는 특성을 하나만 사용할 수 있습니다.Only one attribute can be used for this type of search.

CacheResults CacheResults CacheResults CacheResults

클라이언트 컴퓨터에 결과를 캐시할 것인지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the result is cached on the client computer.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ClientTimeout ClientTimeout ClientTimeout ClientTimeout

서버에서 결과가 반환될 때까지 클라이언트가 기다리는 최대 시간을 가져오거나 설정합니다.Gets or sets the maximum amount of time that the client waits for the server to return results. 이 시간 내에 서버 응답이 없으면 검색이 중단되고 결과가 반환되지 않습니다.If the server does not respond within this time, the search is aborted and no results are returned.

Container Container Container Container

IContainer가 포함된 Component를 가져옵니다.Gets the IContainer that contains the Component.

(Inherited from Component)
DerefAlias DerefAlias DerefAlias DerefAlias

검색 과정에서 검색한 개체의 별칭을 확인하는 방법을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating how the aliases of objects that are found during a search should be resolved.

DesignMode DesignMode DesignMode DesignMode

Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DirectorySynchronization DirectorySynchronization DirectorySynchronization DirectorySynchronization

검색에 사용할 디렉터리 동기화 컨트롤을 나타내는 개체를 가져오거나 설정합니다.Gets or sets an object that represents the directory synchronization control to use with the search.

Events Events Events Events

Component에 연결된 이벤트 처리기의 목록을 가져옵니다.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ExtendedDN ExtendedDN ExtendedDN ExtendedDN

고유 이름의 형식을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates the format of the distinguished names.

Filter Filter Filter Filter

LDAP(Lightweight Directory Access Protocol) 형식의 필터 문자열을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the Lightweight Directory Access Protocol (LDAP) format filter string.

PageSize PageSize PageSize PageSize

페이지 단위 검색의 페이지 크기를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the page size in a paged search.

PropertiesToLoad PropertiesToLoad PropertiesToLoad PropertiesToLoad

검색 과정에서 검색할 속성의 목록을 나타내는 값을 가져옵니다.Gets a value indicating the list of properties to retrieve during the search.

PropertyNamesOnly PropertyNamesOnly PropertyNamesOnly PropertyNamesOnly

값이 할당된 특성의 이름만 검색할 것인지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the search retrieves only the names of attributes to which values have been assigned.

ReferralChasing ReferralChasing ReferralChasing ReferralChasing

조회를 추적하는 방법을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating how referrals are chased.

SearchRoot SearchRoot SearchRoot SearchRoot

Active Directory 도메인 서비스 계층 구조에서 검색이 시작되는 노드를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the node in the Active Directory Domain Services hierarchy where the search starts.

SearchScope SearchScope SearchScope SearchScope

서버에서 관찰하는 검색 범위를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the scope of the search that is observed by the server.

SecurityMasks SecurityMasks SecurityMasks SecurityMasks

검색을 수행하여 반환할 지정된 특성의 보안 액세스 정보를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating which security access information for the specified attributes should be returned by the search.

ServerPageTimeLimit ServerPageTimeLimit ServerPageTimeLimit ServerPageTimeLimit

서버에서 개별 결과 페이지를 검색할 최대 시간을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the maximum amount of time the server should search for an individual page of results. 이 시간은 전체 검색에 대한 시간 제한과 같지 않습니다.This is not the same as the time limit for the entire search.

ServerTimeLimit ServerTimeLimit ServerTimeLimit ServerTimeLimit

ServerTimeLimit 속성은 서버에서 검색을 수행하는 데 걸리는 최대 시간을 나타내는 값을 가져오거나 설정합니다.The ServerTimeLimit property gets or sets a value indicating the maximum amount of time the server spends searching. 시간 제한에 도달하면 그때까지 검색한 엔트리만 반환됩니다.If the time limit is reached, only entries that are found up to that point are returned.

Site Site Site Site

ComponentISite를 가져오거나 설정합니다.Gets or sets the ISite of the Component.

(Inherited from Component)
SizeLimit SizeLimit SizeLimit SizeLimit

검색을 수행했을 때 서버에서 반환하는 최대 개체 수를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the maximum number of objects that the server returns in a search.

Sort Sort Sort Sort

결과가 정렬되는 속성을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the property on which the results are sorted.

Tombstone Tombstone Tombstone Tombstone

검색을 수행하여 검색 필터와 일치하는 삭제된 개체도 반환할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the search should also return deleted objects that match the search filter.

VirtualListView VirtualListView VirtualListView VirtualListView

검색에 대한 가상 목록 보기 옵션을 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating the virtual list view options for the search.

메서드

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Component에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

DirectorySearcher 개체에서 사용하는 관리되는 리소스를 해제하고 관리되지 않는 리소스를 선택적으로 해제합니다.Releases the managed resources that are used by the DirectorySearcher object and, optionally, releases unmanaged resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindAll() FindAll() FindAll() FindAll()

검색을 실행하고 검색한 엔트리 컬렉션을 반환합니다.Executes the search and returns a collection of the entries that are found.

FindOne() FindOne() FindOne() FindOne()

검색을 실행하고 첫 번째로 검색한 엔트리만 반환합니다.Executes the search and returns only the first entry that is found.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Component의 이름이 포함된 String을 반환합니다(있는 경우).Returns a String containing the name of the Component, if any. 이 메서드는 재정의할 수 없습니다.This method should not be overridden.

(Inherited from Component)

이벤트

Disposed Disposed Disposed Disposed

Dispose() 메서드를 호출하여 구성 요소가 삭제되는 경우 발생합니다.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

보안

DirectoryServicesPermission
LinkDemand

적용 대상

추가 정보