DirectoryEntry オブジェクト

[アーティクル]
09/12/2008

System.DirectoryServices では、ディレクトリ内の各オブジェクトは DirectoryEntry オブジェクトで表されます。DirectoryEntry は、メモリ内にエントリオブジェクトを作成します。CommitChanges メソッドが呼び出されるまでは、ディレクトリ内に実際のオブジェクトが作成されることはありません。この利点は、ディレクトリにアクセスするための情報をクライアントアプリケーションから取得し、その情報の読み取りや変更をローカルで行ってから、サーバーに再接続し、変更した情報をディレクトリに保存できる点にあります。これによって、サーバーのパフォーマンスを最高に保つことができます。

各ネットワークリソースは、ディレクトリ内でオブジェクトとして表され、各ディレクトリオブジェクトは、前に述べたように、クライアントアプリケーションでは DirectoryEntry として表されます。

ディレクトリエントリオブジェクトには次の特性があります。

Name。オブジェクト名は、相対識別名 (RDN: relative distinguished name) とも呼ばれます。RDN の形式は、キー=値という構文を使用します。たとえば、次の図では、ユーザーオブジェクトの RDN は CN=Jeff Smith です。スペースは除かれることに注意してください。
Parent。ネットワークオブジェクトは階層になっており、ルートオブジェクトより下位のオブジェクトには親オブジェクトがあります。ルートオブジェクトはドメインオブジェクトであり、階層の最上位に位置し、ドメインヘッドと呼ばれることもあります。
Path。ディレクトリオブジェクトパスは、識別名 (DN: distinguished name) とも呼ばれます。識別名は、ルートオブジェクトまでの各親オブジェクトの名前が前に付いたオブジェクト名で構築されます。たとえば、ユーザーオブジェクト CN=Jeff Smith の場合、DN は DC=Fabrikam,DC=COM,OU=Sales,CN=Jeff Smith のように、ルートオブジェクトで始まり、ユーザーオブジェクトまでのパスをたどります。パスでは、LDAP 仕様で定義された構文が使用されます。パスの正しい構文の詳細については、「バインド文字列」を参照してください。パスは、DirectoryEntry オブジェクトで作成されたバインド文字列で使用されます。

オブジェクトパスモデル

前に述べた情報は、System.DirectoryServices を使用して接続するいずれの LDAP ディレクトリオブジェクトにも当てはまりますが、Active Directory ドメインサービス固有のものもあります。Active Directory ドメインサービスオブジェクトの 1 つの特徴は、それらがグローバル一意識別子 (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);

次の方法で共有

DirectoryEntry オブジェクト

関連項目

リファレンス

概念

その他のリソース