Partilhar via


DirectoryEntries.Add(String, String) Método

Definição

Cria uma nova entrada no contêiner.

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

name
String

O nome da nova entrada.

schemaClassName
String

O nome do esquema usado para a nova entrada.

Retornos

Um objeto DirectoryEntry que representa a nova entrada.

Exceções

Erro durante a chamada à interface subjacente.

Exemplos

O exemplo do .NET do Visual Basic a seguir cria um novo DirectoryEntry objeto com um caminho especificado e, em seguida, cria uma nova entrada no contêiner e o salva.

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

O exemplo de C# a seguir cria um novo DirectoryEntry objeto com um caminho especificado e, em seguida, cria uma nova entrada no contêiner e o salva.

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

O exemplo C++ a seguir cria um novo DirectoryEntry objeto com um caminho especificado e, em seguida, cria uma nova entrada no contêiner e o salva.

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

Comentários

Você deve chamar o CommitChanges método na nova entrada para tornar a criação permanente. Ao chamar esse método, você pode definir valores de propriedade obrigatórios na nova entrada. Cada um dos provedores tem requisitos diferentes para propriedades que precisam ser definidas antes que uma chamada para o CommitChanges método seja feita. Se esses requisitos não forem atendidos, o provedor poderá gerar uma exceção. Verifique com seu provedor para determinar quais propriedades devem ser definidas antes de confirmar as alterações.

Aplica-se a