DirectoryEntries.Add(String, String) Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

DirectoryEntries.cs

Erstellt einen neuen Eintrag im Container.

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

Der Name des neuen Eintrags.

schemaClassName

String

Der Name des für diesen neuen Eintrag verwendeten Schemas.

Gibt zurück

DirectoryEntry

Ein DirectoryEntry-Objekt, das den neuen Eintrag darstellt.

Ausnahmen

COMException

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.

Beispiele

Im folgenden Visual Basic .NET-Beispiel wird ein neues DirectoryEntry -Objekt mit einem angegebenen Pfad erstellt. Anschließend wird ein neuer Eintrag im Container erstellt und gespeichert.

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

Im folgenden C#-Beispiel wird ein neues DirectoryEntry Objekt mit einem angegebenen Pfad erstellt, anschließend ein neuer Eintrag im Container erstellt und gespeichert.

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

Im folgenden C++-Beispiel wird ein neues DirectoryEntry Objekt mit einem angegebenen Pfad erstellt, anschließend ein neuer Eintrag im Container erstellt und gespeichert.

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

Hinweise

Sie müssen die CommitChanges -Methode für den neuen Eintrag aufrufen, um die Erstellung dauerhaft zu machen. Wenn Sie diese Methode aufrufen, können Sie dann obligatorische Eigenschaftswerte für den neuen Eintrag festlegen. Die Anbieter haben jeweils unterschiedliche Anforderungen an Eigenschaften, die festgelegt werden müssen, bevor ein Aufruf der CommitChanges -Methode erfolgt. Wenn diese Anforderungen nicht erfüllt sind, löst der Anbieter möglicherweise eine Ausnahme aus. Wenden Sie sich an Ihren Anbieter, um zu ermitteln, welche Eigenschaften festgelegt werden müssen, bevor Sie Änderungen committen.