DirectoryEntry Класс

Определение

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

System.DirectoryServices

Сборка:

System.DirectoryServices.dll

Пакет:

System.DirectoryServices v8.0.0

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

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, служба каталогов Novell NetWare (NDS) и WinNT.

Примечание

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

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

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

Свойства

AuthenticationType	Возвращает или задает используемый тип аутентификации.
CanRaiseEvents	Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
Children	Возвращает дочерние записи данного узла в иерархии доменных служб Active Directory.
Container	Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
DesignMode	Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
Guid	Возвращает GUID объекта DirectoryEntry.
Name	Возвращает имя объекта, присвоенное базовой службой каталогов.
NativeGuid	Получает GUID объекта DirectoryEntry, возвращенный поставщиком.
NativeObject	Возвращает собственный объект интерфейса ADSI.
ObjectSecurity	Возвращает или задает дескриптор безопасности для данной записи.
Options	Возвращает характерные для поставщика параметры данной записи.
Parent	Возвращает родителя данной записи в иерархии доменных служб Active Directory.
Password	Задает пароль, используемый при аутентификации клиента.
Path	Возвращает или задает путь к данному объекту DirectoryEntry.
Properties	Возвращает свойства доменных служб Active Directory для данного объекта DirectoryEntry.
SchemaClassName	Возвращает имя класса схемы для данного объекта DirectoryEntry.
SchemaEntry	Возвращает объект схемы для данной записи.
Site	Получает или задает ISite объекта Component. (Унаследовано от 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()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)

События

Disposed

Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)