DirectoryEntries.Add(String, String) Método

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Origem:

DirectoryEntries.cs

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

DirectoryEntry

Um objeto DirectoryEntry que representa a nova entrada.

Exceções

COMException

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.