DirectoryEntry Класс

Определение

Класс DirectoryEntry инкапсулирует узел или объект иерархии доменных служб Active Directory.The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

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

Комментарии

Этот класс используется для привязки к объектам или чтения и обновления атрибутов.Use this class for binding to objects, or reading and updating attributes. DirectoryEntry, а также вспомогательные классы обеспечивают поддержку управления жизненным циклом и методов навигации.DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. К ним относятся создание, удаление, переименование, перемещение дочернего узла и перечисление дочерних узлов.These include creating, deleting, renaming, moving a child node, and enumerating children. После изменения узла необходимо зафиксировать изменения, чтобы сохранить их в дереве.After you modify a node, you must commit your changes in order for them to be saved to the tree. Дополнительные сведения см. в описании свойства CommitChanges.For more information, see the CommitChanges property.

DirectoryEntry можно использовать для доступа к обычным записям, а также к некоторым (но не всем) данным из записей схемы.DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

Иерархия служб домен Active Directory содержит до нескольких тысяч узлов.The Active Directory Domain Services hierarchy contains up to several thousand nodes. Каждый узел представляет объект, например сетевой принтер или пользователя в домене.Each node represents an object, such as a network printer or a user in a domain. Корпоративные сети постоянно меняются по мере найма новых сотрудников и добавления таких объектов, как сетевые принтеры и компьютеры.Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Технология интерфейсов Active Directory служб (ADSI) предоставляет способы программного добавления этих объектов в дерево каталогов.Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

Чтобы создать запись каталога в иерархии, используйте свойство Children.To create a directory entry in the hierarchy, use the Children property. Свойство Children — это коллекция, предоставляющая метод Add, через который вы добавляете узел в коллекцию непосредственно под родительским узлом, к которому в данный момент привязан объект.The Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. При добавлении узла в коллекцию необходимо указать имя нового узла и имя шаблона схемы, который необходимо связать с узлом.When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. Например, можно использовать схему с названием «Computer» для добавления новых компьютеров в иерархию.For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

Этот класс также содержит кэширование атрибутов, которое может быть полезно для оптимизации сетевого трафика.This class also contains attribute caching, which can be useful for optimizing network traffic. Сведения об использовании кэширования атрибутов см. в описании свойства UsePropertyCache.To use attribute caching, see the UsePropertyCache property.

Классы, связанные с компонентом DirectoryEntry, можно использовать с любыми поставщиками служб домен Active Directory Services.The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. К некоторым из текущих поставщиков относятся службы IIS (IIS), протокол LDAP, Novell NetWare Directory Service (NDS) и WinNT.Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

Примечание

Предполагается, что у вас есть общее представление о службах домен Active Directory, прежде чем использовать этот класс.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Дополнительные сведения см. в разделе Общие сведения о пространстве имен System.DirectoryServices.For more information, see the System.DirectoryServices namespace overview.

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

DirectoryEntry()

Инициализирует новый экземпляр класса DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object)

Инициализирует новый экземпляр класса DirectoryEntry, который привязывается к указанному собственному объекту доменных служб Active Directory.Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String)

Инициализирует новый экземпляр класса DirectoryEntry, который привязывает этот экземпляр к узлу доменных служб Active Directory, расположенному по указанному пути.Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String)

Инициализирует новый экземпляр класса DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes)

Инициализирует новый экземпляр класса DirectoryEntry.Initializes a new instance of the DirectoryEntry class.

Свойства

AuthenticationType

Возвращает или задает используемый тип аутентификации.Gets or sets the type of authentication to use.

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Children

Возвращает дочерние записи данного узла в иерархии доменных служб Active Directory.Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
Guid

Получает GUID объекта DirectoryEntry.Gets the GUID of the DirectoryEntry.

Name

Возвращает имя объекта, присвоенное базовой службой каталогов.Gets the name of the object as named with the underlying directory service.

NativeGuid

Получает GUID объекта DirectoryEntry, возвращенный поставщиком.Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject

Возвращает собственный объект интерфейса ADSI.Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity

Возвращает или задает дескриптор безопасности для данной записи.Gets or sets the security descriptor for this entry.

Options

Возвращает характерные для поставщика параметры данной записи.Gets the provider-specific options for this entry.

Parent

Возвращает родителя данной записи в иерархии доменных служб Active Directory.Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password

Задает пароль, используемый при аутентификации клиента.Sets the password to use when authenticating the client.

Path

Возвращает или задает путь к данному объекту DirectoryEntry.Gets or sets the path for this DirectoryEntry.

Properties

Возвращает свойства доменных служб Active Directory для данного объекта DirectoryEntry.Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName

Возвращает имя класса схемы для данного объекта DirectoryEntry.Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry

Возвращает объект схемы для данной записи.Gets the schema object for this entry.

Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
UsePropertyCache

Возвращает или задает значение, указывающее, следует ли фиксировать кэш после каждой операции.Gets or sets a value indicating whether the cache should be committed after each operation.

Username

Возвращает или задает имя пользователя, используемое при аутентификации клиента.Gets or sets the user name to use when authenticating the client.

Методы

Close()

Закрывает объект DirectoryEntry и освобождает все системные ресурсы, связанные с данным компонентом.Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges()

Сохраняет изменения, внесенные в запись каталога в базовом хранилище каталогов.Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry)

Создает копию данной записи в качестве дочернего элемента указанного родителя.Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String)

Создает копию данного объекта DirectoryEntry в качестве дочернего элемента указанного родительского объекта DirectoryEntry с заданным новым именем.Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
DeleteTree()

Удаляет данную запись и все ее поддерево из иерархии доменных служб Active Directory.Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Удаляет ресурсы (кроме памяти), используемые объектом DirectoryEntry.Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Exists(String)

Определяет, представляет ли указанный путь фактическую запись в службе каталогов.Determines if the specified path represents an actual entry in the directory service.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
Invoke(String, Object[])

Вызывает метод для собственного объекта доменных служб Active Directory.Calls a method on the native Active Directory Domain Services object.

InvokeGet(String)

Возвращает свойство собственного объекта доменных служб Active Directory.Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[])

Задает свойство собственного объекта доменных служб Active Directory.Sets a property on the native Active Directory Domain Services object.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
MoveTo(DirectoryEntry)

Перемещает данный объект DirectoryEntry в указанный родительский объект.Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String)

Перемещает данный объект DirectoryEntry в указанный родительский объект и присваивает ему заданное имя.Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache()

Загружает значения свойств данного объекта DirectoryEntry в кэш свойств.Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[])

Загружает значения указанных свойств в кэш свойств.Loads the values of the specified properties into the property cache.

Rename(String)

Изменяет имя данного объекта DirectoryEntry.Changes the name of this DirectoryEntry object.

ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Унаследовано от Component)

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

Безопасность

DirectoryServicesPermission
LinkDemand

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