DirectoryEntries.Add(String, String) Methode

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

Gibt zurück

Ein DirectoryEntry Objekt, das den neuen Eintrag darstellt.

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein neues DirectoryEntry Objekt mit einem angegebenen Pfad erstellt und anschließend 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.")

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

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 verfügen jeweils über unterschiedliche Anforderungen für 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. Erkundigen Sie sich bei Ihrem Anbieter, welche Eigenschaften festgelegt werden müssen, bevor Sie Änderungen übernehmen.