DirectoryEntries.Add(String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает новую запись в контейнере.
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
Параметры
- name
- String
Имя новой записи.
- schemaClassName
- String
Имя схемы, используемой для новой записи.
Возвращаемое значение
Объект DirectoryEntry , представляющий новую запись.
Исключения
Произошла ошибка во время вызова базового интерфейса.
Примеры
В следующем примере создается новый DirectoryEntry объект с указанным путем, а затем создается новая запись в контейнере и сохраняет ее.
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.");
Комментарии
Чтобы сделать создание постоянным, необходимо вызвать CommitChanges метод в новой записи. При вызове этого метода можно задать обязательные значения свойств в новой записи. У каждого поставщика есть разные требования к свойствам, которые необходимо задать перед вызовом CommitChanges метода. Если эти требования не выполнены, поставщик может вызвать исключение. Обратитесь к поставщику, чтобы определить, какие свойства необходимо задать перед фиксацией изменений.