DirectoryEntry DirectoryEntry DirectoryEntry DirectoryEntry Class

Определение

Класс 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 содержит до нескольких тысяч узлов.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. Свойство представляет собой коллекцию, которая Add предоставляет метод, через который вы добавляете узел в коллекцию непосредственно под родительским узлом, к которому в данный момент привязан объект. ChildrenThe 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. Например, можно использовать схему с названием «Computer» для добавления новых компьютеров в иерархию.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 Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. К некоторым из текущих поставщиков относятся службы IIS (IIS), протокол LDAP, Novell NetWare Directory Service (NDS) и 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, прежде чем использовать этот класс.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() DirectoryEntry() DirectoryEntry()

Инициализирует новый экземпляр класса DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object) DirectoryEntry(Object)

Инициализирует новый экземпляр класса DirectoryEntry, который привязывается к указанному объекту доменных служб Active Directory.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String) DirectoryEntry(String)

Инициализирует новый экземпляр класса DirectoryEntry, который привязывает этот экземпляр к узлу доменных служб Active Directory, расположенному по указанному пути.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(String, String, String) DirectoryEntry(String, String, String) DirectoryEntry(String, String, String)

Инициализирует новый экземпляр класса DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes) DirectoryEntry(String, String, String, AuthenticationTypes)

Инициализирует новый экземпляр класса DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

Свойства

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Возвращает или задает используемый тип аутентификации.Gets or sets the type of authentication to use.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Children Children Children Children

Возвращает дочерние записи данного узла в иерархии доменных служб Active Directory.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container Container Container Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Guid Guid Guid Guid

Получает GUID объекта DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name Name Name Name

Возвращает имя объекта, присвоенное базовой службой каталогов.Gets the name of the object as named with the underlying directory service.

NativeGuid NativeGuid NativeGuid NativeGuid

Возвращает GUID объекта DirectoryEntry, возвращенный поставщиком.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject NativeObject NativeObject NativeObject

Возвращает собственный объект ADSI (Active Directory Service Interfaces).Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity ObjectSecurity ObjectSecurity ObjectSecurity

Получает или задает дескриптор безопасности для данного элемента.Gets or sets the security descriptor for this entry.

Options Options Options Options

Возвращает специфические для поставщика параметры данного элемента.Gets the provider-specific options for this entry.

Parent Parent Parent Parent

Возвращает родитель данного элемента в иерархии доменных служб Active Directory.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password Password Password Password

Задает пароль, используемый при проверке подлинности клиента.Sets the password to use when authenticating the client.

Path Path Path Path

Получает или задает путь для данного объекта DirectoryEntry.Gets or sets the path for this DirectoryEntry.

Properties Properties Properties Properties

Возвращает свойства доменных служб Active Directory для данного объекта DirectoryEntry.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName SchemaClassName SchemaClassName SchemaClassName

Возвращает имя класса схемы для данного объекта DirectoryEntry.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry SchemaEntry SchemaEntry SchemaEntry

Возвращает объект схемы для данного элемента.Gets the schema object for this entry.

Site Site Site Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Inherited from Component)
UsePropertyCache UsePropertyCache UsePropertyCache UsePropertyCache

Получает или задает значение, указывающее, следует ли фиксировать кэш после каждой операции.Gets or sets a value indicating whether the cache should be committed after each operation.

Username Username Username Username

Получает или задает имя пользователя, используемое при проверке подлинности клиента.Gets or sets the user name to use when authenticating the client.

Методы

Close() Close() Close() Close()

Закрывает объект DirectoryEntry и освобождает все системные ресурсы, связанные с данным компонентом.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges() CommitChanges() CommitChanges() CommitChanges()

Сохраняет изменения, внесенные в запись каталога в базовом хранилище каталогов.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry) CopyTo(DirectoryEntry)

Создает копию данного элемента в качестве дочернего элемента указанного родителя.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) CopyTo(DirectoryEntry, String) 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) 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)
DeleteTree() DeleteTree() DeleteTree() DeleteTree()

Удаляет данный элемент и все его поддерево из иерархии доменных служб Active Directory.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

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

Удаляет ресурсы (кроме памяти), используемые объектом DirectoryEntry.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

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

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Exists(String) Exists(String) Exists(String) Exists(String)

Определяет, представляет ли указанный путь фактический элемент в службе каталогов.Determines if the specified path represents an actual entry in the directory service.

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)
Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[])

Вызывает метод собственного объекта доменных служб Active Directory.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String) InvokeGet(String) InvokeGet(String) InvokeGet(String)

Возвращает свойство собственного объекта доменных служб Active Directory.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[]) InvokeSet(String, Object[])

Задает свойство собственного объекта доменных служб Active Directory.Sets a property on the native Active Directory Domain Services object.

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)
MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry) MoveTo(DirectoryEntry)

Перемещает данный объект DirectoryEntry к указанному родителю.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String) MoveTo(DirectoryEntry, String)

Перемещает данный объект DirectoryEntry в указанный родительский объект и присваивает ему имя, заданное указанным значением.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache() RefreshCache() RefreshCache() RefreshCache()

Загружает значения свойств данного объекта DirectoryEntry в кэш свойств.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[]) RefreshCache(String[])

Загружает значения указанных свойств в кэш свойств.Loads the values of the specified properties into the property cache.

Rename(String) Rename(String) Rename(String) Rename(String)

Изменяет имя данного объекта DirectoryEntry.Changes the name of this DirectoryEntry object.

ToString() ToString() ToString() ToString()

Возвращает объект String, содержащий имя Component, если оно есть.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

Применяется к