DirectoryEntries.Add メソッド

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

DirectoryEntries.Add メソッド

コンテナに新しいエントリを作成します。

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

Visual Basic (宣言)

Public Function Add ( _
    name As String, _
    schemaClassName As String _
) As DirectoryEntry

Visual Basic (使用法)

Dim instance As DirectoryEntries
Dim name As String
Dim schemaClassName As String
Dim returnValue As DirectoryEntry

returnValue = instance.Add(name, schemaClassName)

C#

public DirectoryEntry Add (
    string name,
    string schemaClassName
)

C++

public:
DirectoryEntry^ Add (
    String^ name, 
    String^ schemaClassName
)

J#

public DirectoryEntry Add (
    String name, 
    String schemaClassName
)

JScript

public function Add (
    name : String, 
    schemaClassName : String
) : DirectoryEntry

パラメータ

name

新しいエントリの名前。

schemaClassName

新しいエントリで使用されるスキーマの名前。

戻り値
新しいエントリを表す DirectoryEntry オブジェクト。

例外

例外の種類	条件
COMException	基になるインターフェイスを呼び出すときにエラーが発生しました。

解説

作成を永続的にするには、新しいエントリの CommitChanges メソッドを呼び出す必要があります。このメソッドを呼び出すと、新しいエントリの必須プロパティ値を設定できます。CommitChanges メソッドを呼び出す前に設定する必要があるプロパティの要件は、プロバイダによって異なります。この要件を満たさない場合は、プロバイダによって例外がスローされることがあります。プロバイダを確認して、変更をコミットする前に設定する必要があるプロパティを判断してください。

使用例

指定したパスを持つ新しい DirectoryEntry オブジェクトを作成し、そのコンテナ内に新しいエントリを作成し、それを保存する Visual Basic .NET コード例を次に示します。

Visual Basic

Dim strPath As String =
 "IIS://localhost/W3SVC/1/Root"
' Create a new 'DirectoryEntry' object with the given path.
Dim myDE As New DirectoryEntry(strPath)
Dim myEntries As DirectoryEntries = myDE.Children
' Create a new entry 'Sample' in the container.
Dim myDirectoryEntry As DirectoryEntry = myEntries.Add("CN=Sample",
 myDE.SchemaClassName)
' Save changes of entry in the 'Active Directory'.
myDirectoryEntry.CommitChanges()
Console.WriteLine(myDirectoryEntry.Name + " entry is created in
 container.")

指定したパスを持つ新しい DirectoryEntry オブジェクトを作成し、そのコンテナ内に新しいエントリを作成し、それを保存する C# コード例を次に示します。

[C#]

String strPath = "IIS://localhost/W3SVC/1/Root";

// Create a new 'DirectoryEntry' object with the given path.
DirectoryEntry myDE = new DirectoryEntry(strPath);
DirectoryEntries myEntries = myDE.Children;

// Create a new entry 'Sample' in the container.
DirectoryEntry myDirectoryEntry = 
   myEntries.Add("CN=Sample", myDE.SchemaClassName);
// Save changes of entry in the 'Active Directory'.
myDirectoryEntry.CommitChanges();
Console.WriteLine (myDirectoryEntry.Name + " entry is created in container.");

指定したパスを持つ新しい DirectoryEntry オブジェクトを作成し、そのコンテナ内に新しいエントリを作成し、それを保存する C++ コード例を次に示します。

String* strPath = S"IIS://localhost/W3SVC/1/Root";

// Create a new 'DirectoryEntry' object with the given path.
DirectoryEntry* myDE = new DirectoryEntry(strPath);
DirectoryEntries* myEntries = myDE->Children;

// Create a new entry 'Sample' in the container.
DirectoryEntry* myDirectoryEntry = myEntries->Add(S"CN=Sample", myDE->SchemaClassName);
// Save changes of entry in the 'Active Directory'.
myDirectoryEntry->CommitChanges();
Console::WriteLine("{0} entry is created in container.", myDirectoryEntry->Name);

プラットフォーム

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

参照

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