DirectoryEntry 类

.NET Framework 4

其他版本

DirectoryEntry 类可封装 Active Directory 域服务层次结构中的节点或对象。

继承层次结构

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.DirectoryServices.DirectoryEntry

命名空间： System.DirectoryServices
程序集： System.DirectoryServices（在 System.DirectoryServices.dll 中）

语法

C++

复制

[DSDescriptionAttribute("DirectoryEntryDesc")]
[SecurityPermissionAttribute(SecurityAction.Assert, Flags = SecurityPermissionFlag.UnmanagedCode)]
[EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true)]
public class DirectoryEntry : Component

DirectoryEntry 类型公开以下成员。

构造函数

	名称	说明
	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	获取 DirectoryEntry 的 GUID。
	Name	获取用基础目录服务命名的对象的名称。
	NativeGuid	获取提供程序返回的 DirectoryEntry 的 GUID。
	NativeObject	获取本机 Active Directory 服务接口 (ADSI) 对象。
	ObjectSecurity	获取或设置此项的安全说明符。
	Options	获取此项的提供程序特定选项。
	Parent	获取 Active Directory 域服务层次结构中此项的父级。
	Password	设置客户端身份验证所使用的密码。
	Path	获取或设置此 DirectoryEntry 的路径。
	Properties	获取此 DirectoryEntry 对象的 Active Directory 域服务属性。
	SchemaClassName	获取用于此 DirectoryEntry 对象的架构类的名称。
	SchemaEntry	获取此项的架构对象。
	Site	获取或设置 Component 的 ISite。（继承自 Component。）
	UsePropertyCache	获取或设置一个值，该值指示在每次运算之后是否应提交缓存。
	Username	获取或设置在对客户端进行身份验证时使用的用户名。

页首

方法

	名称	说明
	Close	关闭 DirectoryEntry 对象并释放与此组件关联的任何系统资源。
	CommitChanges	将目录项所作更改保存到基础目录存储中。
	CopyTo(DirectoryEntry)	创建此项的副本，并将其作为指定父级的子项。
	CopyTo(DirectoryEntry, String)	用指定的新名称创建 DirectoryEntry 对象的副本，并将其作为指定父级 DirectoryEntry 对象的子项。
	CreateObjRef	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。（继承自 MarshalByRefObject。）
	DeleteTree	从 Active Directory 域服务层次结构中删除此项及其整个子树。
	Dispose	释放由 Component 使用的所有资源。（继承自 Component。）
	Dispose(Boolean)	释放 DirectoryEntry 使用的资源（内存除外）。（重写 Component.Dispose(Boolean)。）
	Equals(Object)	确定指定的 Object 是否等于当前的 Object。（继承自 Object。）
	Exists	确定指定路径是否表示目录服务实际项。
	Finalize	在通过垃圾回收将 Component 回收之前，释放非托管资源并执行其他清理操作。（继承自 Component。）
	GetHashCode	用作特定类型的哈希函数。（继承自 Object。）
	GetLifetimeService	检索控制此实例的生存期策略的当前生存期服务对象。（继承自 MarshalByRefObject。）
	GetService	返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。（继承自 Component。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	InitializeLifetimeService	获取控制此实例的生存期策略的生存期服务对象。（继承自 MarshalByRefObject。）
	Invoke	对本机 Active Directory 域服务对象调用方法。
	InvokeGet	获取来自本机 Active Directory 域服务对象的属性。
	InvokeSet	设置本机 Active Directory 域服务对象上的属性。
	MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
	MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。（继承自 MarshalByRefObject。）
	MoveTo(DirectoryEntry)	将此 DirectoryEntry 对象移至指定父级。
	MoveTo(DirectoryEntry, String)	将此 DirectoryEntry 对象移至指定父级，并将其名称变更为指定值。
	RefreshCache	将此 DirectoryEntry 对象的属性值加载到属性缓存中。
	RefreshCache(String())	将指定属性的值加载到属性缓存中。
	Rename	更改此 DirectoryEntry 对象的名称。
	ToString	返回包含 Component 的名称的 String（如果有）。不应重写此方法。（继承自 Component。）

页首

事件

	名称	说明
	Disposed	当通过调用 Dispose 方法释放组件时发生。（继承自 Component。）

页首

备注

使用该类绑定到对象，或读取和更新特性。 DirectoryEntry，与帮助器类一起，为生存期管理和导航方法提供支持。这些包括创建、删除、重命名、移动子节点和枚举子级。修改节点之后，必须提交更改，以便将它们保存到树中。有关更多信息，请参见 CommitChanges 属性。

可以使用 DirectoryEntry 访问架构项中的常规项和一些（但不是所有）信息。

Active Directory 域服务层次结构包含多达数千个的节点。每个节点表示一个对象，如网络打印机或域中的用户。公司网络会因为聘用新员工和添加对象（如网络打印机和计算机）而经常发生变化。 Active Directory 服务接口 (ADSI) 技术提供了以编程方式向目录树中添加这些对象的途径。

若要在层次结构中创建目录项，请使用 Children 属性。 Children 属性是一个集合，提供 Add 方法，通过该方法将节点直接添加到当前绑定到的父节点之下的集合。当向集合中添加节点时，必须指定新节点的名称以及要与该节点相关联的架构模板的名称。例如，您可能需要使用标题为“Computer”的架构在层次结构中添加新的计算机。

该类还包含特性缓存，这对于优化网络流量十分有用。若要使用特性缓存，请参见 UsePropertyCache 属性。

与 DirectoryEntry 组件关联的类可与任何 Active Directory 域服务提供程序一起使用。当前的一些提供程序包括 Internet 信息服务 (IIS)、轻量目录访问协议 (LDAP)、Novell NetWare 目录服务 (NDS) 和 WinNT。

注意
假定您在使用此类之前已大致了解 Active Directory 域服务。有关更多信息，请参见 System.DirectoryServices 命名空间概述。

版本信息

.NET Framework

受以下版本支持：4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

受以下版本支持：4、3.5 SP1

.NET Framework 安全性

DirectoryServicesPermission
LinkDemand

平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared）成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

System.DirectoryServices 命名空间

本文是否对您有所帮助？是否

不准确

深度不够

需要更多代码示例

翻译需要改进

(2000 个剩余字符)

社区内容添加

常见问题