DirectoryEntry クラス

定義

名前空間:

System.DirectoryServices

アセンブリ:

System.DirectoryServices.dll

パッケージ:

System.DirectoryServices v8.0.0

ソース:

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 などがあります。

Note

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

コンストラクター

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

プロパティ

AuthenticationType	使用する認証の種類を取得または設定します。
CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
Children	Active Directory Domain Services 階層でこのノードの子エントリを取得します。
Container	IContainer を含む Component を取得します。 (継承元 Component)
DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component)
Events	Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component)
Guid	DirectoryEntry の GUID を取得します。
Name	基になるディレクトリ サービスで命名されているオブジェクトの名前を取得します。
NativeGuid	プロバイダーが返す DirectoryEntry の GUID を取得します。
NativeObject	ネイティブ Active Directory Service Interfaces (ADSI) オブジェクトを取得します。
ObjectSecurity	このエントリのセキュリティ記述子を取得または設定します。
Options	このエントリのプロバイダー固有のオプションを取得します。
Parent	Active Directory Domain Services 階層でのこのエントリの親を取得します。
Password	クライアントの認証時に使用するパスワードを設定します。
Path	この DirectoryEntry のパスを取得または設定します。
Properties	この DirectoryEntry オブジェクトの Active Directory ドメイン サービスのプロパティを取得します。
SchemaClassName	この DirectoryEntry オブジェクトのスキーマ クラスの名前を取得します。
SchemaEntry	このエントリのスキーマ オブジェクトを取得します。
Site	Component の ISite を取得または設定します。 (継承元 Component)
UsePropertyCache	操作を実行するたびにキャッシュをコミットするかどうかを示す値を取得または設定します。
Username	クライアントの認証時に使用するユーザー名を取得または設定します。

メソッド

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

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component)