此文章由人工翻译。 将光标移到文章的句子上,以查看原文。 |
译文
原文
|
DirectoryEntry 类
DirectoryEntry 类可封装 Active Directory 域服务层次结构中的节点或对象。
System.MarshalByRefObject
System.ComponentModel.Component
System.DirectoryServices.DirectoryEntry
程序集: System.DirectoryServices(在 System.DirectoryServices.dll 中)
[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。) |
使用该类绑定到对象,或读取和更新特性。 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
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 系统要求。
