DirectoryEntries.Add(String, String) DirectoryEntries.Add(String, String) DirectoryEntries.Add(String, String) DirectoryEntries.Add(String, String) Method

Definition

Erstellt einen neuen Eintrag im Container.Creates a new entry in the 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 String String String

Der Name des neuen Eintrags.The name of the new entry.

schemaClassName
String String String String

Der Name des für diesen neuen Eintrag verwendeten Schemas.The name of the schema that is used for the new entry.

Gibt zurück

Ein DirectoryEntry-Objekt, das den neuen Eintrag darstellt.A DirectoryEntry object that represents the new entry.

Ausnahmen

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.An error occurred during the call to the underlying interface.

Beispiele

Im folgenden Visual Basic .NET-Beispiel wird ein DirectoryEntry neues-Objekt mit einem angegebenen Pfad erstellt, anschließend wird ein neuer Eintrag im Container erstellt und gespeichert.The following Visual Basic .NET example creates a new DirectoryEntry object with a specified path, then creates a new entry in the container and saves it.

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 wird ein neuer Eintrag im Container erstellt und gespeichert.The following C# example creates a new DirectoryEntry object with a specified path, then creates a new entry in the container and saves it.

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 wird ein neuer Eintrag im Container erstellt und gespeichert.The following C++ example creates a new DirectoryEntry object with a specified path, then creates a new entry in the container and saves it.

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 aufzurufen, damit die Erstellung dauerhaft ist.You must call the CommitChanges method on the new entry to make the creation permanent. Wenn Sie diese Methode aufgerufen haben, können Sie verbindliche Eigenschaftswerte für den neuen Eintrag festlegen.When you call this method, you can then set mandatory property values on the new entry. Die Anbieter verfügen jeweils über unterschiedliche Anforderungen für Eigenschaften, die vor dem Abrufen der CommitChanges -Methode festgelegt werden müssen.The providers each have different requirements for properties that need to be set before a call to the CommitChanges method is made. Wenn diese Anforderungen nicht erfüllt werden, löst der Anbieter möglicherweise eine Ausnahme aus.If those requirements are not met, the provider might throw an exception. Wenden Sie sich an Ihren Anbieter, um zu bestimmen, welche Eigenschaften vor dem Ausführen von Änderungen festgelegt werden müssenCheck with your provider to determine which properties must be set before committing changes.

Gilt für: