DirectoryEntry Класс

Определение

Пространство имен:

System.DirectoryServices

Сборка:

System.DirectoryServices.dll

Исходный код:

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 содержит до нескольких тысяч узлов. Каждый узел представляет объект, например сетевой принтер или пользователя в домене. Корпоративные сети постоянно изменяются по мере того, как новые сотрудники нанимаются и добавляются такие объекты, как сетевые принтеры и компьютеры. Технология интерфейсов служб Active Directory (ADSI) предоставляет способы программного добавления этих объектов в дерево каталогов.

Чтобы создать запись каталога в иерархии, используйте Children это свойство. Это Children коллекция, предоставляющая Add метод, с помощью которого добавляется узел в коллекцию непосредственно под родительским узлом, к которому вы привязаны. При добавлении узла в коллекцию необходимо указать имя нового узла и имя шаблона схемы, который требуется связать с узлом. Например, может потребоваться использовать схему с названием "Компьютер", чтобы добавить новые компьютеры в иерархию.

Этот класс также содержит кэширование атрибутов, которое может быть полезно для оптимизации сетевого трафика. Сведения об использовании кэширования атрибутов см. в свойстве UsePropertyCache .

Классы, связанные с компонентом DirectoryEntry , можно использовать с любым из поставщиков услуг доменных служб Active Directory. Некоторые из текущих поставщиков — службы IIS, протокол LDAP, служба каталогов NetWare (NDS) и WinNT.

Замечание

Предполагается, что перед использованием этого класса у вас есть общее представление о доменных службах Active Directory. Дополнительные сведения см. в обзоре System.DirectoryServices пространства имен.

Конструкторы

Имя	Описание
DirectoryEntry()	Инициализирует новый экземпляр класса DirectoryEntry.
DirectoryEntry(Object)	Инициализирует новый экземпляр DirectoryEntry класса, который привязывается к указанному объекту доменных служб Active Directory.
DirectoryEntry(String, String, String, AuthenticationTypes)	Инициализирует новый экземпляр класса DirectoryEntry.
DirectoryEntry(String, String, String)	Инициализирует новый экземпляр класса DirectoryEntry.
DirectoryEntry(String)	Инициализирует новый экземпляр класса, который привязывает этот экземпляр DirectoryEntry к узлу в доменных службах Active Directory, расположенных по указанному пути.

Свойства

Имя	Описание
AuthenticationType	Возвращает или задает тип используемой проверки подлинности.
Children	Возвращает дочерние записи этого узла в иерархии доменных служб Active Directory.
Guid	Возвращает GUID объекта DirectoryEntry.
Name	Возвращает имя объекта, именованного базовой службой каталогов.
NativeGuid	Возвращает GUID DirectoryEntryпоставщика.
NativeObject	Возвращает собственный объект интерфейсов служб Active Directory (ADSI).
ObjectSecurity	Возвращает или задает дескриптор безопасности для этой записи.
Options	Возвращает параметры для конкретного поставщика для этой записи.
Parent	Возвращает родительский элемент в иерархии доменных служб Active Directory.
Password	Задает пароль, используемый при проверке подлинности клиента.
Path	Возвращает или задает путь для этого DirectoryEntry.
Properties	Возвращает свойства доменных служб Active Directory для этого DirectoryEntry объекта.
SchemaClassName	Возвращает имя класса схемы для этого DirectoryEntry объекта.
SchemaEntry	Возвращает объект схемы для этой записи.
UsePropertyCache	Возвращает или задает значение, указывающее, следует ли зафиксировать кэш после каждой операции.
Username	Возвращает или задает имя пользователя, используемое при проверке подлинности клиента.

Методы

Имя	Описание
Close()	DirectoryEntry Закрывает объект и освобождает все системные ресурсы, связанные с этим компонентом.
CommitChanges()	Сохраняет изменения, внесенные в запись каталога в базовое хранилище каталогов.
CopyTo(DirectoryEntry, String)	Создает копию этого DirectoryEntry объекта в качестве дочернего элемента указанного родительского DirectoryEntry объекта с указанным новым именем.
CopyTo(DirectoryEntry)	Создает копию этой записи в качестве дочернего элемента указанного родительского элемента.
DeleteTree()	Удаляет эту запись и всю ее поддереву из иерархии доменных служб Active Directory.
Dispose(Boolean)	Удаляет ресурсы (кроме памяти), используемые этим элементом DirectoryEntry.
Exists(String)	Определяет, представляет ли указанный путь фактическую запись в службе каталогов.
Invoke(String, Object[])	Вызывает метод в собственном объекте доменных служб Active Directory.
InvokeGet(String)	Возвращает свойство из собственного объекта доменных служб Active Directory.
InvokeSet(String, Object[])	Задает свойство в собственном объекте доменных служб Active Directory.
MoveTo(DirectoryEntry, String)	Перемещает этот DirectoryEntry объект на указанный родительский объект и изменяет его имя на указанное значение.
MoveTo(DirectoryEntry)	Перемещает этот DirectoryEntry объект на указанный родительский объект.
RefreshCache()	Загружает значения свойств для этого DirectoryEntry объекта в кэш свойств.
RefreshCache(String[])	Загружает значения указанных свойств в кэш свойств.
Rename(String)	Изменяет имя этого DirectoryEntry объекта.