DirectoryEntries.Add(String, String) メソッド

定義

名前空間:

System.DirectoryServices

アセンブリ:

System.DirectoryServices.dll

パッケージ:

System.DirectoryServices v8.0.0

ソース:

DirectoryEntries.cs

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

public:
 System::DirectoryServices::DirectoryEntry ^ Add(System::String ^ name, System::String ^ schemaClassName);

public System.DirectoryServices.DirectoryEntry Add (string name, string schemaClassName);

member this.Add : string * string -> System.DirectoryServices.DirectoryEntry

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

パラメーター

name

String

新しいエントリの名前。

schemaClassName

String

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

戻り値

DirectoryEntry

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

例外

COMException

基になるインターフェイスへの呼び出し中にエラーが発生しました。

例

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

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 Domain Services'.  
myDirectoryEntry.CommitChanges()  
Console.WriteLine(myDirectoryEntry.Name + " entry is created in container.")  

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

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 Domain Services'.  
myDirectoryEntry.CommitChanges();  
Console.WriteLine (myDirectoryEntry.Name + " entry is created in container.");  

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

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 Domain Services'.  
myDirectoryEntry->CommitChanges();  
Console::WriteLine("{0} entry is created in container.", myDirectoryEntry->Name);  

注釈

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