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 метода. Если эти требования не выполнены, поставщик может вызвать исключение. Обратитесь к поставщику, чтобы определить, какие свойства необходимо задать перед фиксацией изменений.

Применяется к