Поделиться через


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 метод , с помощью которого вы добавляете узел в коллекцию непосредственно под родительским узлом, к которому вы привязаны в данный момент. При добавлении узла в коллекцию необходимо указать имя нового узла и имя шаблона схемы, который необходимо связать с узлом. Например, для добавления новых компьютеров в иерархию может потребоваться использовать схему "Компьютер".

Этот класс также содержит кэширование атрибутов, которое может быть полезно для оптимизации сетевого трафика. Сведения об использовании кэширования атрибутов см. в свойстве 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)

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