DirectoryEntryとは? わかりやすく解説

DirectoryEntry イベント


DirectoryEntry クラス

Active Directory 階層のノードまたはオブジェクトをカプセル化する DirectoryEntry クラス。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文構文

Public Class DirectoryEntry
    Inherits Component
Dim instance As DirectoryEntry
public class DirectoryEntry : Component
public ref class DirectoryEntry : public
 Component
public class DirectoryEntry extends Component
public class DirectoryEntry extends
 Component
解説解説

オブジェクトのバインド、または属性の読み取りおよび更新を行うには、このクラスを使用します。ヘルパー クラスと共に、DirectoryEntry は、有効期間管理およびナビゲーション メソッドのサポートを提供します。これらには、子ノードの作成、削除、名前の変更、移動、および子の列挙が含まれます。ノードを変更したら、その変更をコミットして、ツリーに保存する必要があります。詳細については、CommitChanges プロパティのトピックを参照してください。

DirectoryEntry を使用すると、スキーマ エントリから、通常のエントリと、すべてではありませんが一部の情報にアクセスできます。

Active Directory 階層は、最大数千のノードを格納します。各ノードは、ネットワーク プリンタまたはドメイン内のユーザーなどのオブジェクトを表します。企業のネットワークは、新しい従業員が採用されるたびに頻繁に変更され、ネットワーク プリンタやコンピュータなどのオブジェクトが追加されます。ADSI (Active Directory Service Interfaces) 技術を使用すると、プログラムによって、これらのオブジェクトをディレクトリ ツリーに追加できます。

階層内にディレクトリ エントリを作成するには、Children プロパティを使用します。Children プロパティは、Add メソッドを提供するコレクションです。これを使用して、現在バインドされている親ノードの直下のコレクションにノードを追加します。コレクションにノードを追加するときに、新しいノードの名前と、そのノードに関連付けるスキーマ テンプレートの名前を指定する必要があります。たとえば、"Computer" という名前のスキーマを使用して、階層に新しいコンピュータを追加できます。

このクラスには、ネットワーク トラフィックを最適化するために役立つ属性キャッシュもあります。属性キャッシュを使用するには、UsePropertyCache プロパティのトピックを参照してください。

DirectoryEntry コンポーネントに関連付けられるクラスは、任意の Active Directory サービス プロバイダで使用できます。現在のプロバイダには、IIS (Internet Information Services)、LDAP (Lightweight Directory Access Protocol)、NDS (Novell NetWare Directory Service)、WinNT などがあります。

メモメモ

このクラスを使用するには、Active Directory の一般的な知識が必要です。詳細については、System.DirectoryServices 名前空間の概要のトピックを参照してください。

.NET Framework のセキュリティ.NET Framework のセキュリティ
  • DirectoryServicesPermission  LinkDemand
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.DirectoryServices.DirectoryEntry
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DirectoryEntry コンストラクタ ()


DirectoryEntry コンストラクタ (String)

指定したパスにある Active Directory のノードにバインドする DirectoryEntry クラスの新しいインスタンスを初期化します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文構文

public DirectoryEntry (
    string path
)
public:
DirectoryEntry (
    String^ path
)
public DirectoryEntry (
    String path
)
public function DirectoryEntry (
    path : String
)

パラメータ

path

DirectoryEntry(String) をディレクトリにバインドするパス。Path プロパティは、この値に初期化されます。

使用例使用例

DirectoryEntry オブジェクトを指定したパスのディレクトリ エントリにバインドし、そのノードの Children プロパティで指定される各子エントリの Path プロパティを出力するコード例を次に示します。

Public Class PrintChildren
    
    'Entry point which delegates to C-style main Private Function.
    Public Overloads Shared
 Sub Main()
        Main(System.Environment.GetCommandLineArgs())
    End Sub
    
    Overloads Public Shared
 Sub Main(args() As String)
        Dim objDE As DirectoryEntry
        Dim strPath As String
 = "LDAP://DC=onecity,DC=corp,DC=fabrikam,DC=com"
        If args.Length > 0 Then
            strPath = args(1)
        End If 
        ' Create a new DirectoryEntry with the given path.
        objDE = New DirectoryEntry(strPath)
        
        Dim objChildDE As DirectoryEntry
        For Each objChildDE In
  objDE.Children
            Console.WriteLine(objChildDE.Path)
        Next objChildDE
    End Sub 'Main
End Class 'PrintChildren 

public class PrintChildren{
   public static void Main(String[]
 args)
   {
      DirectoryEntry objDE;
      String strPath="LDAP://DC=onecity,DC=corp,DC=fabrikam,DC=com";
      if(args.Length>0)strPath=args[1];
 
      // Create a new DirectoryEntry with the given path.
      objDE=new DirectoryEntry(strPath);
 
      foreach(DirectoryEntry objChildDE in
 objDE.Children)
        Console.WriteLine(objChildDE.Path);
   }
 }
int main()
{
    String^ args[] = Environment::GetCommandLineArgs();
    DirectoryEntry^ objDE;
    String^ strPath = "LDAP://DC=onecity,DC=corp,DC=fabrikam,DC=com";
    if(args->Length>1)
    {
        strPath=args[1];
    }

    // Create a new DirectoryEntry with the given path.
    objDE = gcnew DirectoryEntry(strPath);

    System::Collections::IEnumerator^ enum0 = objDE->Children->GetEnumerator();
    while (enum0->MoveNext())
    {
        DirectoryEntry^ objChildDE = safe_cast<DirectoryEntry^>(enum0->Current);
        Console::WriteLine(objChildDE->Path);
    }
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
  • DirectoryServicesPermission  Demand
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DirectoryEntry コンストラクタ (String, String, String)

DirectoryEntry クラスの新しいインスタンスを初期化します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文構文

.NET Framework のセキュリティ.NET Framework のセキュリティ
  • DirectoryServicesPermission  Demand
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DirectoryEntry コンストラクタ


DirectoryEntry コンストラクタ (String, String, String, AuthenticationTypes)

DirectoryEntry クラスの新しいインスタンスを初期化します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文構文

Public Sub New ( _
    path As String, _
    username As String, _
    password As String, _
    authenticationType As AuthenticationTypes _
)
Dim path As String
Dim username As String
Dim password As String
Dim authenticationType As AuthenticationTypes

Dim instance As New DirectoryEntry(path,
 username, password, authenticationType)
public DirectoryEntry (
    string path,
    string username,
    string password,
    AuthenticationTypes authenticationType
)
public:
DirectoryEntry (
    String^ path, 
    String^ username, 
    String^ password, 
    AuthenticationTypes authenticationType
)
public DirectoryEntry (
    String path, 
    String username, 
    String password, 
    AuthenticationTypes authenticationType
)
public function DirectoryEntry (
    path : String, 
    username : String, 
    password : String, 
    authenticationType : AuthenticationTypes
)

パラメータ

path
username

クライアントの認証時に使用するユーザー名。Username プロパティは、この値に初期化されます。

password
authenticationType

AuthenticationTypes 値の 1 つ。AuthenticationType プロパティは、この値に初期化されます。

.NET Framework のセキュリティ.NET Framework のセキュリティ
  • DirectoryServicesPermission  Demand
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
DirectoryEntry クラス
DirectoryEntry メンバ
System.DirectoryServices 名前空間
Path
Username
Password
AuthenticationTypes 列挙体
AuthenticationType

DirectoryEntry コンストラクタ (Object)

指定したネイティブ Active Directory オブジェクトにバインドする DirectoryEntry クラスの新しいインスタンスを初期化します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文構文

Public Sub New ( _
    adsObject As Object _
)
Dim adsObject As Object

Dim instance As New DirectoryEntry(adsObject)
public DirectoryEntry (
    Object adsObject
)
public:
DirectoryEntry (
    Object^ adsObject
)
public DirectoryEntry (
    Object adsObject
)
public function DirectoryEntry (
    adsObject : Object
)

パラメータ

adsObject

バインドするネイティブ Active Directory オブジェクトの名前。

解説解説
.NET Framework のセキュリティ.NET Framework のセキュリティ
  • DirectoryServicesPermission  Demand
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DirectoryEntry プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ AuthenticationType 使用する認証の種類を取得または設定します。
パブリック プロパティ Children Active Directory 階層でこのノードの子エントリを取得します。
パブリック プロパティ Container  Component を格納している IContainer を取得します。 ( Component から継承されます。)
パブリック プロパティ Guid DirectoryEntry の GUID を取得します。
パブリック プロパティ Name 基になるディレクトリ サービスで命名されているオブジェクトの名前を取得します。
パブリック プロパティ NativeGuid プロバイダが返す DirectoryEntry の GUID を取得します。
パブリック プロパティ NativeObject ADSI オブジェクトを取得します。
パブリック プロパティ ObjectSecurity このエントリのセキュリティ記述子を取得または設定します。
パブリック プロパティ Options このエントリのプロバイダ固有のオプションを取得します。
パブリック プロパティ Parent Active Directory 階層でのエントリの親を取得します。
パブリック プロパティ Password クライアントの認証時に使用するパスワードを設定します。
パブリック プロパティ Path DirectoryEntry のパスを取得または設定します。
パブリック プロパティ Properties この DirectoryEntry オブジェクトの Active Directory のプロパティを取得します。
パブリック プロパティ SchemaClassName この DirectoryEntry オブジェクトのスキーマ クラスの名前を取得します。
パブリック プロパティ SchemaEntry このエントリのスキーマ オブジェクトを取得します。
パブリック プロパティ Site  Component の ISite を取得または設定します。 ( Component から継承されます。)
パブリック プロパティ UsePropertyCache 操作を行うたびにキャッシュをコミットするかどうかを示す値を取得または設定します。
パブリック プロパティ Username クライアントの認証時に使用するユーザー名を取得または設定します。
プロテクト プロパティプロテクト プロパティ
参照参照

関連項目

DirectoryEntry クラス
System.DirectoryServices 名前空間

DirectoryEntry メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close DirectoryEntry オブジェクトを閉じ、このコンポーネントと関連付けられているシステム リソースを解放します。
パブリック メソッド CommitChanges ディレクトリ エントリに加えられた変更を基になるディレクトリ ストアに保存します。
パブリック メソッド CopyTo オーバーロードされます。 このエントリのコピーを作成します。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド DeleteTree Active Directory 階層からエントリとそのサブツリー全体を削除します。
パブリック メソッド Dispose オーバーロードされます。 DirectoryEntry オブジェクトによって使用されているリソースを解放します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Exists 指定したパスがディレクトリ サービスの実際のエントリを表しているかどうかを確認します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Invoke ネイティブ Active Directory オブジェクトでメソッドを呼び出します。
パブリック メソッド InvokeGet ネイティブ Active Directory オブジェクトからプロパティを取得します。
パブリック メソッド InvokeSet ネイティブ Active Directory オブジェクトでプロパティを設定します。
パブリック メソッド MoveTo オーバーロードされます。 この DirectoryEntry を移動します。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド RefreshCache オーバーロードされます。 この DirectoryEntry オブジェクトのプロパティ値をプロパティ キャッシュに読み込みます。
パブリック メソッド Rename この DirectoryEntry オブジェクトの名前を変更します。
パブリック メソッド ToString  Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

DirectoryEntry クラス
System.DirectoryServices 名前空間

DirectoryEntry メンバ

Active Directory 階層のノードまたはオブジェクトをカプセル化する DirectoryEntry クラス。

DirectoryEntry データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ AuthenticationType 使用する認証の種類を取得または設定します。
パブリック プロパティ Children Active Directory 階層でこのノードの子エントリを取得します。
パブリック プロパティ Container  Component を格納している IContainer を取得します。(Component から継承されます。)
パブリック プロパティ Guid DirectoryEntry の GUID を取得します。
パブリック プロパティ Name 基になるディレクトリ サービスで命名されているオブジェクトの名前を取得します。
パブリック プロパティ NativeGuid プロバイダが返す DirectoryEntry の GUID を取得します。
パブリック プロパティ NativeObject 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 オーバーロードされます。 このエントリのコピーを作成します。
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド DeleteTree Active Directory 階層からエントリとそのサブツリー全体を削除します。
パブリック メソッド Dispose オーバーロードされます。 DirectoryEntry オブジェクトによって使用されているリソースを解放します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド Exists 指定したパスがディレクトリ サービスの実際のエントリを表しているかどうかを確認します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Invoke ネイティブ Active Directory オブジェクトでメソッドを呼び出します。
パブリック メソッド InvokeGet ネイティブ Active Directory オブジェクトからプロパティを取得します。
パブリック メソッド InvokeSet ネイティブ Active Directory オブジェクトでプロパティを設定します。
パブリック メソッド MoveTo オーバーロードされます。 この DirectoryEntry を移動します。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド RefreshCache オーバーロードされます。 この DirectoryEntry オブジェクトのプロパティ値をプロパティ キャッシュに読み込みます。
パブリック メソッド Rename この DirectoryEntry オブジェクトの名前を変更します。
パブリック メソッド ToString  Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)
プロテクト メソッドプロテクト メソッド
パブリック イベントパブリック イベント
参照参照

関連項目

DirectoryEntry クラス
System.DirectoryServices 名前空間



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「DirectoryEntry」の関連用語

DirectoryEntryのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



DirectoryEntryのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS