DirectoryEntries.Add(String, String) Método

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Paquete:

System.DirectoryServices v8.0.0

Source:

DirectoryEntries.cs

Crea una nueva entrada en el contenedor.

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

Nombre de la nueva entrada.

schemaClassName

String

Nombre del esquema utilizado para la nueva entrada.

Devoluciones

DirectoryEntry

Objeto DirectoryEntry que representa la nueva entrada.

Excepciones

COMException

Se produjo un error durante la llamada a la interfaz subyacente.

Ejemplos

En el siguiente ejemplo de Visual Basic .NET se crea un nuevo DirectoryEntry objeto con una ruta de acceso especificada y, a continuación, se crea una nueva entrada en el contenedor y se guarda.

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

En el ejemplo de C# siguiente se crea un nuevo DirectoryEntry objeto con una ruta de acceso especificada y, a continuación, se crea una nueva entrada en el contenedor y se guarda.

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

En el ejemplo de C++ siguiente se crea un nuevo DirectoryEntry objeto con una ruta de acceso especificada y, a continuación, se crea una nueva entrada en el contenedor y se guarda.

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

Comentarios

Debe llamar al CommitChanges método en la nueva entrada para que la creación sea permanente. Al llamar a este método, puede establecer valores de propiedad obligatorios en la nueva entrada. Cada uno de los proveedores tiene requisitos diferentes para las propiedades que deben establecerse antes de realizar una llamada al CommitChanges método . Si no se cumplen esos requisitos, el proveedor podría producir una excepción. Consulte con el proveedor para determinar qué propiedades deben establecerse antes de confirmar los cambios.