DirectoryEntries.Add(String, String) Método

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

Parâmetros

Devoluções

Um DirectoryEntry objeto que representa a nova entrada.

Exceções

Exemplos

O exemplo seguinte cria um novo DirectoryEntry objeto com um caminho especificado, depois cria uma nova entrada no contentor e guarda-a.

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

Observações

Deve chamar o CommitChanges método na nova entrada para tornar a criação permanente. Ao chamar este método, pode então definir valores obrigatórios das propriedades na nova entrada. Os fornecedores têm requisitos diferentes para propriedades que precisam de ser definidas antes de ser feita uma chamada para o CommitChanges método. Se esses requisitos não forem cumpridos, o prestador pode lançar uma exceção. Consulte o seu fornecedor para determinar quais os imóveis que devem ser definidos antes de fazer alterações.