DirectoryEntry 클래스

정의

네임스페이스:

System.DirectoryServices

어셈블리:

System.DirectoryServices.dll

패키지:

System.DirectoryServices v8.0.0

Source:

DirectoryEntry.cs

DirectoryEntry 클래스는 Active Directory 도메인 서비스 계층 구조의 노드나 개체를 캡슐화합니다.

public ref class DirectoryEntry : System::ComponentModel::Component

[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component

[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

상속

Object

MarshalByRefObject

Component

DirectoryEntry

특성

TypeConverterAttribute

설명

개체에 바인딩하거나 특성을 읽고 업데이트하려면 이 클래스를 사용합니다. DirectoryEntry는 도우미 클래스와 함께 수명 주기 관리 및 탐색 방법을 지원합니다. 여기에는 자식 노드 만들기, 삭제, 이름 바꾸기, 자식 노드 이동 및 자식 열거가 포함됩니다. 노드를 수정한 후에는 변경 내용을 트리에 저장하기 위해 커밋해야 합니다. 자세한 내용은 CommitChanges 속성을 참조하세요.

DirectoryEntry 는 스키마 항목의 일반 항목 및 일부 정보(전부는 아님)에 액세스하는 데 사용할 수 있습니다.

Active Directory Domain Services 계층에는 최대 수천 개의 노드가 포함됩니다. 각 노드는 네트워크 프린터 또는 도메인의 사용자와 같은 개체를 나타냅니다. 회사 네트워크는 신입 사원이 고용되고 네트워크 프린터 및 컴퓨터와 같은 개체가 추가됨에 따라 지속적으로 변경됩니다. ADSI(Active Directory Service Interfaces) 기술은 이러한 개체를 디렉터리 트리에 프로그래밍 방식으로 추가하는 방법을 제공합니다.

계층에서 디렉터리 항목을 만들려면 사용 된 Children 속성입니다. 속성은 Children 메서드를 Add 제공하는 컬렉션으로, 현재 바인딩된 부모 노드 바로 아래에 있는 컬렉션에 노드를 추가합니다. 컬렉션에 노드를 추가할 때 새 노드의 이름과 노드와 연결하려는 스키마 템플릿의 이름을 지정해야 합니다. 예를 들어 "컴퓨터"라는 스키마를 사용하여 계층에 새 컴퓨터를 추가할 수 있습니다.

이 클래스에는 네트워크 트래픽을 최적화하는 데 유용할 수 있는 특성 캐싱도 포함되어 있습니다. 특성 캐싱을 사용하려면 속성을 참조 UsePropertyCache 하세요.

구성 요소와 DirectoryEntry 연결된 클래스는 Active Directory Domain Services 서비스 공급자와 함께 사용할 수 있습니다. 현재 공급자 중 일부는 IIS(인터넷 정보 서비스), LDAP(Lightweight Directory Access Protocol), Novell NetWare Directory Service(NDS) 및 WinNT입니다.

참고

이 클래스를 사용하기 전에 Active Directory Domain Services 대한 일반적인 이해가 있다고 가정합니다. 자세한 내용은 네임스페이스 개요를 System.DirectoryServices 참조하세요.

생성자

DirectoryEntry()	DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.
DirectoryEntry(Object)	지정된 네이티브 Active Directory 도메인 서비스 개체에 바인딩되는 DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.
DirectoryEntry(String)	지정된 경로에 있는 Active Directory 도메인 서비스의 노드에 이 인스턴스를 바인딩하는 DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.
DirectoryEntry(String, String, String)	DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.
DirectoryEntry(String, String, String, AuthenticationTypes)	DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.

속성

AuthenticationType	사용할 인증 형식을 가져오거나 설정합니다.
CanRaiseEvents	구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component)
Children	Active Directory Domain Services 계층 구조에서 이 노드의 자식 항목을 가져옵니다.
Container	IContainer을 포함하는 Component를 가져옵니다. (다음에서 상속됨 Component)
DesignMode	Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component)
Events	이 Component에 연결된 이벤트 처리기의 목록을 가져옵니다. (다음에서 상속됨 Component)
Guid	DirectoryEntry의 GUID를 가져옵니다.
Name	내부 디렉터리 서비스와 이름이 같은 개체의 이름을 가져옵니다.
NativeGuid	공급자가 반환하는 것과 같은 DirectoryEntry의 GUID를 가져옵니다.
NativeObject	네이티브 ADSI(Active Directory Service Interfaces) 개체를 가져옵니다.
ObjectSecurity	이 엔트리의 보안 설명자를 가져오거나 설정합니다.
Options	이 엔트리에 대한 공급자별 옵션을 가져옵니다.
Parent	Active Directory 도메인 서비스 계층 구조에 있는 이 엔트리의 부모를 가져옵니다.
Password	클라이언트를 인증할 때 사용할 암호를 설정합니다.
Path	이 DirectoryEntry의 경로를 가져오거나 설정합니다.
Properties	이 DirectoryEntry 개체의 Active Directory 도메인 서비스 속성을 가져옵니다.
SchemaClassName	이 DirectoryEntry 개체에 대한 스키마 클래스의 이름을 가져옵니다.
SchemaEntry	이 엔트리의 스키마 개체를 가져옵니다.
Site	Component의 ISite를 가져오거나 설정합니다. (다음에서 상속됨 Component)
UsePropertyCache	각 작업이 끝난 후 캐시를 커밋할 것인지 여부를 나타내는 값을 가져오거나 설정합니다.
Username	클라이언트를 인증할 때 사용할 사용자 이름을 가져오거나 설정합니다.

메서드

Close()	DirectoryEntry 개체를 닫고 이 구성 요소와 연결된 시스템 리소스를 모두 해제합니다.
CommitChanges()	디렉터리 항목의 변경 내용을 내부 디렉터리 저장소에 저장합니다.
CopyTo(DirectoryEntry)	이 엔트리를 복사하고 복사본을 지정된 부모의 자식으로 만듭니다.
CopyTo(DirectoryEntry, String)	새 이름을 지정하여 지정된 부모 DirectoryEntry 개체의 자식으로 이 DirectoryEntry 개체의 복사본을 만듭니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
DeleteTree()	Active Directory 도메인 서비스 계층 구조에서 이 엔트리와 이 엔트리의 전체 하위 트리를 삭제합니다.
Dispose()	Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component)
Dispose(Boolean)	DirectoryEntry에서 사용하는 리소스(메모리 제외)를 삭제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Exists(String)	지정된 경로가 디렉터리 서비스의 실제 엔트리를 나타내는지 여부를 확인합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetLifetimeService()	이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetService(Type)	Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다. (다음에서 상속됨 Component)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
InitializeLifetimeService()	이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
Invoke(String, Object[])	네이티브 Active Directory 도메인 서비스 개체에 대해 메서드를 호출합니다.
InvokeGet(String)	네이티브 Active Directory 도메인 서비스 개체에서 속성을 가져옵니다.
InvokeSet(String, Object[])	네이티브 Active Directory 도메인 서비스 개체의 속성을 설정합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
MoveTo(DirectoryEntry)	이 DirectoryEntry 개체를 지정된 부모로 이동합니다.
MoveTo(DirectoryEntry, String)	이 DirectoryEntry 개체를 지정된 부모로 이동하고 그 이름을 지정된 값으로 변경합니다.
RefreshCache()	이 DirectoryEntry 개체의 속성 값을 속성 캐시에 로드합니다.
RefreshCache(String[])	지정된 속성의 값을 속성 캐시에 로드합니다.
Rename(String)	이 DirectoryEntry 개체의 이름을 변경합니다.
ToString()	Component의 이름이 포함된 String을 반환합니다(있는 경우). 이 메서드는 재정의할 수 없습니다. (다음에서 상속됨 Component)

이벤트

Disposed

Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component)