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) |