DirectoryEntry.Path プロパティ

.NET Framework クラス ライブラリ リファレンス

DirectoryEntry.Path プロパティ

DirectoryEntry のパスを取得または設定します。

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

Visual Basic (宣言)

Public Property Path As
 String

Visual Basic (使用法)

Dim instance As DirectoryEntry
Dim value As String

value = instance.Path

instance.Path = value

C#

public string Path { get;
 set; }

C++

public:
property String^ Path {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Path ()

/** @property */
public void set_Path (String value)

JScript

public function get Path
 () : String

public function set Path
 (value : String)

プロパティ値
この DirectoryEntry オブジェクトのパス。既定値は空の文字列 ("") です。

解説

Path プロパティは、ネットワーク環境でこのエントリを一意に識別します。このエントリは、常に Path を使用して取得できます。

Path を設定すると、ディレクトリ ストアから新しいエントリが取得されます。現在バインドされているエントリのパスは変更されません。

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

メモ
Path のプロバイダを識別するセクション ("://" の前) では、大文字と小文字が区別されます。たとえば、"LDAP://" または "WinNT://" のようになります。

Path プロパティの構文は、プロバイダによって異なります。共通する例を次に示します。

WinNT

• コンピュータ上のグループに接続します。たとえば、"WinNT://<ドメイン名>/<コンピュータ名>/<グループ名>" のようになります。ローカル コンピュータに接続する場合は、"WinNT://<コンピュータ名>/<グループ名>" です。

• コンピュータ上のユーザーに接続します。たとえば、"WinNT://<ドメイン名>/<コンピュータ名>/<ユーザー名>" のようになります。ローカル コンピュータに接続する場合は、"WinNT://<コンピュータ名>/<ユーザー名>" です。

• コンピュータ上のサービスに接続します。たとえば、"WinNT://<ドメイン名>/<コンピュータ名>/<サービス名>" のようになります。ローカル コンピュータに接続する場合は、"WinNT://<コンピュータ名>/<サービス名>" です。

• ネットワーク上のすべてのドメインを探索します。たとえば、"WinNT:" で、ドメインは、このエントリの子を列挙することによって検出できます。

LDAP

• ドメイン内のグループに接続します。たとえば、"LDAP://CN=<グループ名>, CN =<ユーザー>, DC=<ドメイン コンポーネント>, DC=<ドメイン コンポーネント>,..." のようになります。

• ドメイン内のユーザーに接続します。たとえば、"LDAP://CN=<完全ユーザー名>, CN=<ユーザー>, DC=<ドメイン コンポーネント>, DC=<ドメイン コンポーネント>,..." のようになります。

• ドメイン内のコンピュータに接続します。たとえば、"LDAP://CN=<コンピュータ名>, CN=<コンピュータ>, DC=<ドメイン コンポーネント>, DC=<ドメイン コンポーネント>,..." のようになります。

IIS

• Web ディレクトリに接続します。たとえば、"IIS://LocalHost/W3SVC/1/ROOT/<Web ディレクトリ名>" のようになります。

LDAP を使用して現在のドメインにバインドするには、パス "LDAP://RootDSE" を使用し、既定の名前付けコンテキストを取得して、そのエントリを再バインドします。次に例を示します。

C#

String str = ent.Properties["defaultNamingContext"][0];
DirectoryEntry domain = new DirectoryEntry("LDAP://"
 + str);

詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library) の「Using Active Directory Services Interface」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DirectoryEntry クラス
DirectoryEntry メンバ
System.DirectoryServices 名前空間