DirectoryEntry 类 (System.DirectoryServices)

切换视图

全部折叠

语言筛选器

此页面仅适用于

Microsoft Visual Studio 2008/.NET Framework 3.5

同时提供下列产品的其他版本：

.NET Framework 类库

DirectoryEntry 类

更新：2007 年 11 月

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

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

语法

Visual Basic（声明）

<DSDescriptionAttribute("DirectoryEntryDesc")> _
<SecurityPermissionAttribute(SecurityAction.Assert, Flags := SecurityPermissionFlag.UnmanagedCode)> _
<EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted := True)> _
<DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted := True)> _
Public Class DirectoryEntry _
    Inherits Component

Visual Basic (用法)

Dim instance As DirectoryEntry

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

Visual C++

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

/** @attribute DSDescriptionAttribute("DirectoryEntryDesc") */
/** @attribute SecurityPermissionAttribute(SecurityAction.Assert, Flags = SecurityPermissionFlag.UnmanagedCode) */
/** @attribute EnvironmentPermissionAttribute(SecurityAction.Assert, Unrestricted = true) */
/** @attribute DirectoryServicesPermissionAttribute(SecurityAction.LinkDemand, Unrestricted = true) */
public class DirectoryEntry extends Component

JScript

public class DirectoryEntry extends 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 命名空间概述。

权限

DirectoryServicesPermission
LinkDemand

继承层次结构

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

线程安全

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

平台

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

版本信息

.NET Framework

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

另请参见

参考

DirectoryEntry 成员

System.DirectoryServices 命名空间

标记

: 添加标记

社区内容

添加新内容

批注

个人信息中心 | 法律信息 | MSDN Flash 中心 | 联系我们