DirectoryEntry 클래스

정의

DirectoryEntry 클래스는 Active Directory 도메인 서비스 계층 구조의 노드나 개체를 캡슐화합니다.The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

public ref class DirectoryEntry : System::ComponentModel::Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
상속
특성

설명

개체에 바인딩 또는 읽기 및 업데이트 특성에 대 한이 클래스를 사용 합니다.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry도우미 클래스와 함께 지원 수명 주기에 대 한 관리 및 탐색 메서드 제공 합니다.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. 여기에 만들기, 삭제, 이름 바꾸기, 자식 노드를 이동 및 자식을 열거이 포함 됩니다.These include creating, deleting, renaming, moving a child node, and enumerating children. 노드를 수정한 후에 트리를 저장할 수 있도록에서 변경 내용을 커밋해야 합니다.After you modify a node, you must commit your changes in order for them to be saved to the tree. 자세한 내용은 CommitChanges 속성을 참조하세요.For more information, see the CommitChanges property.

DirectoryEntry 스키마 항목에서 일반 항목과 전부는 아니지만 일부 정보에 액세스를 사용할 수 있습니다.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

Active Directory Domain Services 계층은 최대 몇 천 노드 포함 되어 있습니다.The Active Directory Domain Services hierarchy contains up to several thousand nodes. 각 노드는 네트워크 프린터 등 도메인의 사용자 개체를 나타냅니다.Each node represents an object, such as a network printer or a user in a domain. 회사 네트워크는 새 직원을 채용 하 고 네트워크 프린터 등의 컴퓨터 개체는 추가 지속적으로 변경 합니다.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Active Directory 서비스 인터페이스 (ADSI) 기술에는 프로그래밍 방식으로 이러한 개체를 디렉터리 트리를 추가 하는 방법을 제공 합니다.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

계층의 디렉터리 항목을 만들려면 사용 합니다 Children 속성입니다.To create a directory entry in the hierarchy, use the Children property. 합니다 Children 속성이 제공 하는 컬렉션을 Add 노드 컬렉션에 현재 바인딩되어 있는 부모 노드 바로 아래에 추가 하는 메서드.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. 노드 컬렉션에 추가할 때 새 노드 이름과 노드를 사용 하 여 연결 하려는 스키마 서식 파일의 이름을 지정 해야 합니다.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. 예를 들어, 다음 계층에 새 컴퓨터를 추가 하려면 "컴퓨터" 라는 스키마를 사용 하는 것이 좋습니다.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

이 클래스도 포함 특성 캐싱 네트워크 트래픽을 최적화 하는 데 유용할 수 있습니다.This class also contains attribute caching, which can be useful for optimizing network traffic. 특성 캐시를 사용 하려면 참조는 UsePropertyCache 속성입니다.To use attribute caching, see the UsePropertyCache property.

연결 된 클래스는 DirectoryEntry Active Directory Domain Services 서비스 공급자 중 하나를 사용 하 여 구성 요소를 사용할 수 있습니다.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. 현재 공급자 중 일부에 인터넷 정보 서비스 (IIS), LDAP Lightweight Directory Access Protocol (), Novell NetWare NDS Directory Service (), 및 WinNT 됩니다.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

참고

이 클래스를 사용 하기 전에 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 namespace overview.

생성자

DirectoryEntry()

DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object)

지정된 네이티브 Active Directory 도메인 서비스 개체에 바인딩되는 DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String)

지정된 경로에 있는 Active Directory 도메인 서비스의 노드에 이 인스턴스를 바인딩하는 DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String)

DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes)

DirectoryEntry 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DirectoryEntry class.

속성

AuthenticationType

사용할 인증 형식을 가져오거나 설정합니다.Gets or sets the type of authentication to use.

CanRaiseEvents

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

(다음에서 상속됨 Component)
Children

Active Directory Domain Services 계층 구조에서 이 노드의 자식 항목을 가져옵니다.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container

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

(다음에서 상속됨 Component)
DesignMode

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

(다음에서 상속됨 Component)
Events

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

(다음에서 상속됨 Component)
Guid

DirectoryEntry의 GUID를 가져옵니다.Gets the GUID of the DirectoryEntry.

Name

내부 디렉터리 서비스와 이름이 같은 개체의 이름을 가져옵니다.Gets the name of the object as named with the underlying directory service.

NativeGuid

공급자가 반환하는 것과 같은 DirectoryEntry의 GUID를 가져옵니다.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject

네이티브 ADSI(Active Directory Service Interfaces) 개체를 가져옵니다.Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity

이 엔트리의 보안 설명자를 가져오거나 설정합니다.Gets or sets the security descriptor for this entry.

Options

이 엔트리에 대한 공급자별 옵션을 가져옵니다.Gets the provider-specific options for this entry.

Parent

Active Directory 도메인 서비스 계층 구조에 있는 이 엔트리의 부모를 가져옵니다.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password

클라이언트를 인증할 때 사용할 암호를 설정합니다.Sets the password to use when authenticating the client.

Path

DirectoryEntry의 경로를 가져오거나 설정합니다.Gets or sets the path for this DirectoryEntry.

Properties

DirectoryEntry 개체의 Active Directory 도메인 서비스 속성을 가져옵니다.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName

DirectoryEntry 개체에 대한 스키마 클래스의 이름을 가져옵니다.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry

이 엔트리의 스키마 개체를 가져옵니다.Gets the schema object for this entry.

Site

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

(다음에서 상속됨 Component)
UsePropertyCache

각 작업이 끝난 후 캐시를 커밋할 것인지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the cache should be committed after each operation.

Username

클라이언트를 인증할 때 사용할 사용자 이름을 가져오거나 설정합니다.Gets or sets the user name to use when authenticating the client.

메서드

Close()

DirectoryEntry 개체를 닫고 이 구성 요소와 연결된 시스템 리소스를 모두 해제합니다.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges()

디렉터리 항목의 변경 내용을 내부 디렉터리 저장소에 저장합니다.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry)

이 엔트리를 복사하고 복사본을 지정된 부모의 자식으로 만듭니다.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String)

새 이름을 지정하여 지정된 부모 DirectoryEntry 개체의 자식으로 이 DirectoryEntry 개체의 복사본을 만듭니다.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type)

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

(다음에서 상속됨 MarshalByRefObject)
DeleteTree()

Active Directory 도메인 서비스 계층 구조에서 이 엔트리와 이 엔트리의 전체 하위 트리를 삭제합니다.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose()

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

(다음에서 상속됨 Component)
Dispose(Boolean)

DirectoryEntry에서 사용하는 리소스(메모리 제외)를 삭제합니다.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object)

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

(다음에서 상속됨 Object)
Exists(String)

지정된 경로가 디렉터리 서비스의 실제 엔트리를 나타내는지 여부를 확인합니다.Determines if the specified path represents an actual entry in the directory service.

GetHashCode()

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

(다음에서 상속됨 Object)
GetLifetimeService()

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

(다음에서 상속됨 MarshalByRefObject)
GetService(Type)

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

(다음에서 상속됨 Component)
GetType()

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

(다음에서 상속됨 Object)
InitializeLifetimeService()

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

(다음에서 상속됨 MarshalByRefObject)
Invoke(String, Object[])

네이티브 Active Directory 도메인 서비스 개체에 대해 메서드를 호출합니다.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String)

네이티브 Active Directory 도메인 서비스 개체에서 속성을 가져옵니다.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[])

네이티브 Active Directory 도메인 서비스 개체의 속성을 설정합니다.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone()

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

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

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

(다음에서 상속됨 MarshalByRefObject)
MoveTo(DirectoryEntry)

DirectoryEntry 개체를 지정된 부모로 이동합니다.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String)

DirectoryEntry 개체를 지정된 부모로 이동하고 그 이름을 지정된 값으로 변경합니다.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache()

DirectoryEntry 개체의 속성 값을 속성 캐시에 로드합니다.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[])

지정된 속성의 값을 속성 캐시에 로드합니다.Loads the values of the specified properties into the property cache.

Rename(String)

DirectoryEntry 개체의 이름을 변경합니다.Changes the name of this DirectoryEntry object.

ToString()

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

(다음에서 상속됨 Component)

이벤트

Disposed

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

(다음에서 상속됨 Component)

보안

DirectoryServicesPermission
LinkDemand

적용 대상