DirectoryEntries.Add(String, String) Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacchetto:

System.DirectoryServices v8.0.0

Origine:

DirectoryEntries.cs

Crea una nuova voce nel contenitore.

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

Parametri

name

String

Il nome della nuova voce.

schemaClassName

String

Nome dello schema utilizzato per la nuova voce.

Restituisce

DirectoryEntry

Oggetto DirectoryEntry che rappresenta la nuova voce.

Eccezioni

COMException

Si è verificato un errore durante la chiamata all'interfaccia sottostante.

Esempio

L'esempio .NET di Visual Basic seguente crea un nuovo DirectoryEntry oggetto con un percorso specificato, quindi crea una nuova voce nel contenitore e la 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.")  

L'esempio C# seguente crea un nuovo DirectoryEntry oggetto con un percorso specificato, quindi crea una nuova voce nel contenitore e la 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.");  

L'esempio C++ seguente crea un nuovo DirectoryEntry oggetto con un percorso specificato, quindi crea una nuova voce nel contenitore e la 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);  

Commenti

È necessario chiamare il CommitChanges metodo sulla nuova voce per rendere permanente la creazione. Quando si chiama questo metodo, è quindi possibile impostare i valori delle proprietà obbligatorie nella nuova voce. I provider hanno requisiti diversi per le proprietà che devono essere impostate prima che venga effettuata una chiamata al CommitChanges metodo. Se tali requisiti non sono soddisfatti, il provider potrebbe generare un'eccezione. Controllare con il provider per determinare quali proprietà devono essere impostate prima di eseguire il commit delle modifiche.