DirectoryEntry Класс

Определение

Класс DirectoryEntry инкапсулирует узел или объект иерархии доменных служб Active Directory.

public ref class DirectoryEntry : System::ComponentModel::Component
public class DirectoryEntry : System.ComponentModel.Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public 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))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component
[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
[<System.DirectoryServices.DSDescription("DirectoryEntryDesc")>]
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
Наследование
Атрибуты

Комментарии

Этот класс используется для привязки к объектам или чтения и обновления атрибутов. DirectoryEntryНаряду с вспомогательными классами обеспечивает поддержку управления жизненным циклом и методов навигации. К ним относятся создание, удаление, переименование, перемещение дочернего узла и перечисление дочерних узлов. После изменения узла необходимо зафиксировать изменения, чтобы сохранить их в дереве. Дополнительные сведения см. в описании свойства CommitChanges.

DirectoryEntry может использоваться для доступа к обычным записям, а также к некоторым, но не всем данным из записей схемы.

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

Чтобы создать запись каталога в иерархии, используйте Children свойство. ChildrenСвойство представляет собой коллекцию, которая предоставляет Add метод, через который вы добавляете узел в коллекцию непосредственно под родительским узлом, к которому в данный момент привязан объект. При добавлении узла в коллекцию необходимо указать имя нового узла и имя шаблона схемы, который необходимо связать с узлом. Например, можно использовать схему с названием «Computer» для добавления новых компьютеров в иерархию.

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

Классы, связанные с DirectoryEntry компонентом, можно использовать с любыми поставщиками служб домен Active Directory Services. К некоторым из текущих поставщиков относятся службы IIS (IIS), протокол LDAP, Novell NetWare Directory Service (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)

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