按一下以給予評分及指教
全部折疊/全部展開 全部折疊
本頁僅適用於
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
C#
[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
J#
/** @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

使用這個類別以繫結至物件、讀取和更新屬性 (Attribute)。DirectoryEntry 與 Helper 類別提供生命週期管理和巡覽方法的支援。包括建立、刪除、重新命名、移除子節點和列舉子系。在修改或節點之後,您必須認可您的變更,以便讓它們儲存到樹狀結構中。如需詳細資訊,請參閱 CommitChanges 屬性。

DirectoryEntry 可以用來存取一般項目,以及結構描述項目的部分 (非全部) 資訊。

Active Directory 網域服務階層架構包含高達數千個節點。每一個節點代表一個物件,例如,網路印表機或網域中的使用者。因為新員工和物件 (例如,網路印表機和電腦) 的加入,使得企業網路會經常性地變更。Active Directory Service Interfaces (ADSI) 技術提供方法來以程式設計方式將這些物件加入目錄樹狀結構。

若要建立階層架構中的目錄,請使用 Children 屬性。Children 屬性是一種集合,提供 Add 方法,藉由這個方法可以直接在您目前所繫結的父節點下方將節點加入集合中。將節點加入至集合時,必須指定新節點的名稱,以及要與該節點產生關聯之結構描述樣板的名稱。例如,您可能想要使用標題為 "Computer" 的結構描述來將新電腦加入階層架構。

這個類別還包含屬性快取,在最佳化網路流量時很有用。若要使用屬性 (Attribute) 快取,請參閱 UsePropertyCache 屬性 (Property)。

DirectoryEntry 元件關聯的類別可以搭配任何 Active Directory 網域服務的服務提供者使用。目前提供者有些是網際網路資訊服務 (IIS)、輕量型目錄存取協定 (LDAP)、Novell NetWare Directory Service (NDS) 和 WinNT。

注意事項:

假設您在使用這個類別之前已對 Active Directory 網域服務有一般性了解。如需詳細資訊,請參閱 System.DirectoryServices 命名空間 (Namespace) 概觀。

System..::.Object
  System..::.MarshalByRefObject
    System.ComponentModel..::.Component
      System.DirectoryServices..::.DirectoryEntry
這個型別的任何 Public 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
社群內容   什麼是社群內容?
新增內容 RSS  註解
Processing
© 2009 Microsoft Corporation. 著作權所有,並保留一切權利。 使用規定 | 商標 | 隱私權聲明
Page view tracker