DirectoryEntry クラス

定義

名前空間:

System.DirectoryServices

アセンブリ:

System.DirectoryServices.dll

ソース:

DirectoryEntry.cs

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

public ref class DirectoryEntry : System::ComponentModel::Component

[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component

[<System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))>]
type DirectoryEntry = class
    inherit Component

Public Class DirectoryEntry
Inherits Component

継承

Object

MarshalByRefObject

Component

DirectoryEntry

属性

TypeConverterAttribute

注釈

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

DirectoryEntry は、通常のエントリと、スキーマ エントリからの一部の (すべてではない) 情報にアクセスするために使用できます。

Active Directory Domain Services 階層には、最大で数千のノードが含まれています。 各ノードは、ネットワーク プリンターやドメイン内のユーザーなどのオブジェクトを表します。 新入社員が採用され、ネットワーク プリンターやコンピューターなどのオブジェクトが追加されると、企業ネットワークは絶えず変化します。 Active Directory サービス インターフェイス (ADSI) テクノロジでは、これらのオブジェクトをディレクトリ ツリーにプログラムで追加する方法が提供されます。

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

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

DirectoryEntry コンポーネントに関連付けられているクラスは、任意の Active Directory Domain Services サービス プロバイダーで使用できます。 現在のプロバイダーには、インターネット インフォメーション サービス (IIS)、ライトウェイト ディレクトリ アクセス プロトコル (LDAP)、Novell NetWare Directory Service (NDS)、WinNT があります。

注

このクラスを使用する前に、Active Directory Domain Services に関する一般的な理解があることを前提としています。 詳細については、 System.DirectoryServices 名前空間の概要を参照してください。

コンストラクター

名前	説明
DirectoryEntry()	DirectoryEntry クラスの新しいインスタンスを初期化します。
DirectoryEntry(Object)	指定したネイティブ Active Directory Domain Services オブジェクトにバインドする DirectoryEntry クラスの新しいインスタンスを初期化します。
DirectoryEntry(String, String, String, AuthenticationTypes)	DirectoryEntry クラスの新しいインスタンスを初期化します。
DirectoryEntry(String, String, String)	DirectoryEntry クラスの新しいインスタンスを初期化します。
DirectoryEntry(String)	指定したパスにある Active Directory Domain Services 内のノードにこのインスタンスをバインドする、 DirectoryEntry クラスの新しいインスタンスを初期化します。

プロパティ

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

メソッド

名前	説明
Close()	DirectoryEntry オブジェクトを閉じ、このコンポーネントに関連付けられているシステム リソースをすべて解放します。
CommitChanges()	ディレクトリ エントリに加えられた変更を、基になるディレクトリ ストアに保存します。
CopyTo(DirectoryEntry, String)	指定した新しい名前を持つ、指定した親DirectoryEntry オブジェクトの子として、このDirectoryEntry オブジェクトのコピーを作成します。
CopyTo(DirectoryEntry)	指定した親の子としてこのエントリのコピーを作成します。
DeleteTree()	このエントリとそのサブツリー全体を Active Directory Domain Services 階層から削除します。
Dispose(Boolean)	DirectoryEntryによって使用されるリソース (メモリ以外) を破棄します。
Exists(String)	指定したパスがディレクトリ サービスの実際のエントリを表すかどうかを判断します。
Invoke(String, Object[])	ネイティブ Active Directory Domain Services オブジェクトに対してメソッドを呼び出します。
InvokeGet(String)	ネイティブ Active Directory Domain Services オブジェクトからプロパティを取得します。
InvokeSet(String, Object[])	ネイティブ Active Directory Domain Services オブジェクトのプロパティを設定します。
MoveTo(DirectoryEntry, String)	この DirectoryEntry オブジェクトを指定した親に移動し、その名前を指定した値に変更します。
MoveTo(DirectoryEntry)	この DirectoryEntry オブジェクトを指定した親に移動します。
RefreshCache()	この DirectoryEntry オブジェクトのプロパティ値をプロパティ キャッシュに読み込みます。
RefreshCache(String[])	指定したプロパティの値をプロパティ キャッシュに読み込みます。
Rename(String)	この DirectoryEntry オブジェクトの名前を変更します。