DirectoryEntries.Add(String, String) Metode

Definisi

Ruang nama:

System.DirectoryServices

Rakitan:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Sumber:

DirectoryEntries.cs

Membuat entri baru dalam kontainer.

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

Parameter

name

String

Nama entri baru.

schemaClassName

String

Nama skema yang digunakan untuk entri baru.

Mengembalikan

DirectoryEntry

Objek DirectoryEntry yang mewakili entri baru.

Pengecualian

COMException

Terjadi kesalahan selama panggilan ke antarmuka yang mendasar.

Contoh

Contoh .NET Visual Basic berikut membuat objek baru DirectoryEntry dengan jalur tertentu, lalu membuat entri baru dalam kontainer dan menyimpannya.

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.")  

Contoh C# berikut membuat objek baru DirectoryEntry dengan jalur tertentu, lalu membuat entri baru dalam kontainer dan menyimpannya.

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.");  

Contoh C++ berikut membuat objek baru DirectoryEntry dengan jalur tertentu, lalu membuat entri baru dalam kontainer dan menyimpannya.

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);  

Keterangan

Anda harus memanggil CommitChanges metode pada entri baru untuk membuat pembuatan permanen. Ketika Anda memanggil metode ini, Anda kemudian dapat mengatur nilai properti wajib pada entri baru. Masing-masing penyedia memiliki persyaratan yang berbeda untuk properti yang perlu diatur sebelum panggilan ke CommitChanges metode dilakukan. Jika persyaratan tersebut tidak terpenuhi, penyedia mungkin melemparkan pengecualian. Tanyakan kepada penyedia Anda untuk menentukan properti mana yang harus diatur sebelum melakukan perubahan.