DirectoryEntry クラス

定義

DirectoryEntry クラスは、Active Directory ドメイン サービス階層のノードまたはオブジェクトをカプセル化します。The DirectoryEntry class encapsulates a node or object in the Active Directory Domain Services hierarchy.

public ref class DirectoryEntry : System::ComponentModel::Component
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.Design.DirectoryEntryConverter))]
[System.DirectoryServices.DSDescription("DirectoryEntryDesc")]
[System.ComponentModel.TypeConverter(typeof(System.DirectoryServices.DirectoryEntryConverter))]
public class DirectoryEntry : System.ComponentModel.Component
type DirectoryEntry = class
    inherit Component
Public Class DirectoryEntry
Inherits Component
継承
属性

注釈

このクラスは、オブジェクトへのバインド、または属性の読み取りと更新に使用します。Use this class for binding to objects, or reading and updating attributes. DirectoryEntryは、ヘルパークラスと共に、ライフサイクル管理およびナビゲーションメソッドをサポートします。DirectoryEntry, along with helper classes, provides support for life-cycle management and navigation methods. これには、子ノードの作成、削除、名前変更、移動、および子の列挙が含まれます。These include creating, deleting, renaming, moving a child node, and enumerating children. ノードを変更した後は、変更をツリーに保存するために、変更をコミットする必要があります。After you modify a node, you must commit your changes in order for them to be saved to the tree. 詳細については、CommitChanges プロパティを参照してください。For more information, see the CommitChanges property.

DirectoryEntryを使用すると、通常のエントリにアクセスしたり、スキーマエントリからすべてではなく一部の情報にアクセスしたりできます。DirectoryEntry can be used to access regular entries and some, but not all, information from schema entries.

Active Directory Domain Services 階層には、最大で数千のノードが含まれます。The Active Directory Domain Services hierarchy contains up to several thousand nodes. 各ノードは、ネットワークプリンターやドメイン内のユーザーなどのオブジェクトを表します。Each node represents an object, such as a network printer or a user in a domain. 企業ネットワークは、新しい従業員が採用され、ネットワークプリンターやコンピューターなどのオブジェクトが追加されると常に変化します。Corporate networks constantly change as new employees are hired and objects such as network printers and computers are added. Active Directory サービスインターフェイス (ADSI) テクノロジは、これらのオブジェクトをプログラムによってディレクトリツリーに追加する方法を提供します。Active Directory Service Interfaces (ADSI) technology provides ways to programmatically add these objects to the directory tree.

階層内にディレクトリエントリを作成するには、 Childrenプロパティを使用します。To create a directory entry in the hierarchy, use the Children property. プロパティは、現在バインドされてAddいる親ノードのすぐ下にあるコレクションにノードを追加するために使用する、メソッドを提供するコレクションです。 ChildrenThe Children property is a collection that provides an Add method, through which you add a node to the collection directly below the parent node that you are currently bound to. ノードをコレクションに追加する場合は、新しいノードの名前と、ノードに関連付けるスキーマテンプレートの名前を指定する必要があります。When adding a node to the collection, you must specify a name for the new node and the name of a schema template that you want to associate with the node. たとえば、"Computer" という名前のスキーマを使用して、階層に新しいコンピューターを追加することができます。For example, you might want to use a schema titled "Computer" to add new computers to the hierarchy.

このクラスには、ネットワークトラフィックを最適化するのに役立つ属性キャッシュも含まれています。This class also contains attribute caching, which can be useful for optimizing network traffic. 属性キャッシュを使用するにはUsePropertyCache 、プロパティを参照してください。To use attribute caching, see the UsePropertyCache property.

DirectoryEntryコンポーネントに関連付けられているクラスは、任意の Active Directory Domain Services サービスプロバイダーで使用できます。The classes associated with the DirectoryEntry component can be used with any of the Active Directory Domain Services service providers. 現在のプロバイダーには、インターネットインフォメーションサービス (IIS)、ライトウェイトディレクトリアクセスプロトコル (LDAP)、Novell NetWare ディレクトリサービス (NDS)、および WinNT があります。Some of the current providers are Internet Information Services (IIS), Lightweight Directory Access Protocol (LDAP), Novell NetWare Directory Service (NDS), and WinNT.

注意

このクラスを使用する前に、Active Directory Domain Services についての全般的な知識があることを前提としています。It is assumed that you have a general understanding of Active Directory Domain Services before using this class. 詳細については、 System.DirectoryServices 「名前空間の概要」を参照してください。For more information, see the System.DirectoryServices namespace overview.

コンストラクター

DirectoryEntry()

DirectoryEntry クラスの新しいインスタンスを初期化します。Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(Object)

指定したネイティブ Active Directory ドメイン サービス オブジェクトにバインドする DirectoryEntry クラスの新しいインスタンスを初期化します。Initializes a new instance of the DirectoryEntry class that binds to the specified native Active Directory Domain Services object.

DirectoryEntry(String)

指定したパスにある Active Directory ドメイン サービスのノードにバインドする DirectoryEntry クラスの新しいインスタンスを初期化します。Initializes a new instance of the DirectoryEntry class that binds this instance to the node in Active Directory Domain Services located at the specified path.

DirectoryEntry(String, String, String)

DirectoryEntry クラスの新しいインスタンスを初期化します。Initializes a new instance of the DirectoryEntry class.

DirectoryEntry(String, String, String, AuthenticationTypes)

DirectoryEntry クラスの新しいインスタンスを初期化します。Initializes a new instance of the DirectoryEntry class.

プロパティ

AuthenticationType

使用する認証の種類を取得または設定します。Gets or sets the type of authentication to use.

CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(継承元 Component)
Children

Active Directory ドメイン サービス階層でこのノードの子エントリを取得します。Gets the child entries of this node in the Active Directory Domain Services hierarchy.

Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(継承元 Component)
DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(継承元 Component)
Guid

DirectoryEntry の GUID を取得します。Gets the GUID of the DirectoryEntry.

Name

基になるディレクトリ サービスで命名されているオブジェクトの名前を取得します。Gets the name of the object as named with the underlying directory service.

NativeGuid

プロバイダーが返す DirectoryEntry の GUID を取得します。Gets the GUID of the DirectoryEntry, as returned from the provider.

NativeObject

ADSI オブジェクトを取得します。Gets the native Active Directory Service Interfaces (ADSI) object.

ObjectSecurity

このエントリのセキュリティ記述子を取得または設定します。Gets or sets the security descriptor for this entry.

Options

このエントリのプロバイダー固有のオプションを取得します。Gets the provider-specific options for this entry.

Parent

Active Directory ドメイン サービス階層でのエントリの親を取得します。Gets this entry's parent in the Active Directory Domain Services hierarchy.

Password

クライアントの認証時に使用するパスワードを設定します。Sets the password to use when authenticating the client.

Path

DirectoryEntry のパスを取得または設定します。Gets or sets the path for this DirectoryEntry.

Properties

この DirectoryEntry オブジェクトの Active Directory ドメイン サービス プロパティを取得します。Gets the Active Directory Domain Services properties for this DirectoryEntry object.

SchemaClassName

この DirectoryEntry オブジェクトのスキーマ クラスの名前を取得します。Gets the name of the schema class for this DirectoryEntry object.

SchemaEntry

このエントリのスキーマ オブジェクトを取得します。Gets the schema object for this entry.

Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(継承元 Component)
UsePropertyCache

操作を行うたびにキャッシュをコミットするかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the cache should be committed after each operation.

Username

クライアントの認証時に使用するユーザー名を取得または設定します。Gets or sets the user name to use when authenticating the client.

メソッド

Close()

DirectoryEntry オブジェクトを閉じ、このコンポーネントと関連付けられているシステム リソースを解放します。Closes the DirectoryEntry object and releases any system resources that are associated with this component.

CommitChanges()

ディレクトリ エントリに加えられた変更を基になるディレクトリ ストアに保存します。Saves changes that are made to a directory entry to the underlying directory store.

CopyTo(DirectoryEntry)

指定した親の子として、エントリのコピーを作成します。Creates a copy of this entry as a child of the specified parent.

CopyTo(DirectoryEntry, String)

指定した新しい名前で、指定した親 DirectoryEntry オブジェクトの子として、この DirectoryEntry オブジェクトのコピーを作成します。Creates a copy of this DirectoryEntry object, as a child of the specified parent DirectoryEntry object, with the specified new name.

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
DeleteTree()

Active Directory ドメイン サービス階層からエントリとそのサブツリー全体を削除します。Deletes this entry and its entire subtree from the Active Directory Domain Services hierarchy.

Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(継承元 Component)
Dispose(Boolean)

DirectoryEntry で使用されているリソース (メモリを除く) を解放します。Disposes of the resources (other than memory) that are used by the DirectoryEntry.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
Exists(String)

指定したパスがディレクトリ サービスの実際のエントリを表しているかどうかを確認します。Determines if the specified path represents an actual entry in the directory service.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
Invoke(String, Object[])

ネイティブ Active Directory ドメイン サービス オブジェクトでメソッドを呼び出します。Calls a method on the native Active Directory Domain Services object.

InvokeGet(String)

ネイティブ Active Directory ドメイン サービス オブジェクトからプロパティを取得します。Gets a property from the native Active Directory Domain Services object.

InvokeSet(String, Object[])

ネイティブ Active Directory ドメイン サービス オブジェクトでプロパティを設定します。Sets a property on the native Active Directory Domain Services object.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
MoveTo(DirectoryEntry)

この DirectoryEntry オブジェクトを指定した親に移動します。Moves this DirectoryEntry object to the specified parent.

MoveTo(DirectoryEntry, String)

この DirectoryEntry オブジェクトを指定した親に移動し、その名前を指定した値に変更します。Moves this DirectoryEntry object to the specified parent and changes its name to the specified value.

RefreshCache()

この DirectoryEntry オブジェクトのプロパティ値をプロパティ キャッシュに読み込みます。Loads the property values for this DirectoryEntry object into the property cache.

RefreshCache(String[])

指定したプロパティの値をプロパティ キャッシュに読み込みます。Loads the values of the specified properties into the property cache.

Rename(String)

この DirectoryEntry オブジェクトの名前を変更します。Changes the name of this DirectoryEntry object.

ToString()

Component の名前 (存在する場合) を格納する String を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

(継承元 Component)

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(継承元 Component)

セキュリティ

DirectoryServicesPermission
LinkDemand

適用対象