DirectoryEntry 物件

發行項
09/12/2008

在 System.DirectoryServices 中，目錄中的每個物件會以 DirectoryEntry 物件來表示。DirectoryEntry 會在記憶體中建立項目物件；在呼叫 CommitChanges 方法之前，它不會在目錄中實際建立物件。其優點在於您可為來自用戶端應用程式的存取擷取目錄資訊，在重新連線到伺服器之前在本機讀取或修改該資訊，以將修改的資訊存入目錄中。如此可使伺服器維持尖峰執行效能。

每個網路資源在目錄中均以一個物件表示，而每個目錄物件 (如前所述) 在用戶端應用程式中則以 DirectoryEntry 表示。

目錄項目物件具有下列特性：

Name。物件名稱也稱為相對辨別名稱 (RDN)。RDN 的格式使用 key=value 語法。例如，在下圖中，使用者物件的 RDN 是 CN=Jeff Smith。請注意空格已被排除。
Parent。網路物件是階層式的，在達到根物件之前有父代物件，根物件是網域物件，有時候稱為網域標頭，位於階層最上方。
Path。目錄物件路徑也稱為辨別名稱 (DN)。辨別名稱由物件名稱前面加上每個父代物件名稱 (到根物件為止) 所構成。例如，對於使用者物件 CN=Jeff Smith，其 DN 從根物件開始，後面接著使用者物件的路徑，如下所示：DC=Fabrikam,DC=COM,OU=Sales,CN=Jeff Smith。路徑使用 LDAP 規格所定義的語法。如需有關路徑適當語法的詳細資訊，請參閱繫結字串。路徑可用於以 DirectoryEntry 物件所建立的繫結字串中。

雖然先前的資訊適用於您使用 System.DirectoryServices 連線的任何 LDAP 目錄物件，但還有一些 Active Directory 網域服務專用的項目。Active Directory 網域服務物件的特性之一，是它們必須包含全域唯一識別碼 (GUID)。雖然可修改物件上不同屬性的值，但 GUID 是永遠不變的。

下列程式碼範例示範如何建立 DirectoryEntry 並寫入其路徑、名稱以及 GUID。在此範例中，DirectoryEntry 繫結至這個使用者目前連線之網域的根目錄。

Imports System.DirectoryServices
'...
Dim entry As New DirectoryEntry()
Console.WriteLine(entry.Path)
Console.WriteLine(entry.Name)
Console.WriteLine(entry.Guid)

using System.DirectoryServices;
//...
DirectoryEntry entry = new DirectoryEntry();
Console.WriteLine(entry.Path);
Console.WriteLine(entry.Name);
Console.WriteLine(entry.Guid);

請參閱

參考

System.DirectoryServices
DirectoryEntry

概念

System.DirectoryServices 使用者入門
 繫結字串

Send comments about this topic to Microsoft.

共用方式為

DirectoryEntry 物件

請參閱

參考

概念

其他資源