DirectoryEntries.Add(String, String) Yöntem

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Kaynak:

DirectoryEntries.cs

Kapsayıcıda yeni bir giriş oluşturur.

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

Parametreler

name

String

Yeni girdinin adı.

schemaClassName

String

Yeni giriş için kullanılan şemanın adı.

Döndürülenler

DirectoryEntry

DirectoryEntry Yeni girişi temsil eden bir nesne.

Özel durumlar

COMException

Temel arabirime yapılan çağrı sırasında bir hata oluştu.

Örnekler

Aşağıdaki Visual Basic .NET örneği, belirtilen yola sahip yeni DirectoryEntry bir nesne oluşturur, ardından kapsayıcıda yeni bir giriş oluşturur ve bunu kaydeder.

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

Aşağıdaki C# örneği, belirtilen yola sahip yeni DirectoryEntry bir nesne oluşturur, ardından kapsayıcıda yeni bir giriş oluşturur ve bunu kaydeder.

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

Aşağıdaki C++ örneği, belirtilen yola sahip yeni DirectoryEntry bir nesne oluşturur, ardından kapsayıcıda yeni bir giriş oluşturur ve bunu kaydeder.

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

Açıklamalar

Oluşturma işlemini CommitChanges kalıcı hale getirmek için yeni girişte yöntemini çağırmanız gerekir. Bu yöntemi çağırdığınızda, daha sonra yeni girişte zorunlu özellik değerleri ayarlayabilirsiniz. Sağlayıcıların her biri, yöntem çağrısı yapılmadan önce ayarlanması gereken özellikler için farklı gereksinimlere CommitChanges sahiptir. Bu gereksinimler karşılanmazsa sağlayıcı bir özel durum oluşturabilir. Değişiklikleri işlemeden önce hangi özelliklerin ayarlanması gerektiğini belirlemek için sağlayıcınıza danışın.