DirectoryEntries.Add(String, String) Méthode

Définition

Espace de noms:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paquet:

System.DirectoryServices v8.0.0

Source:

DirectoryEntries.cs

Crée une entrée dans le conteneur.

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

Paramètres

name

String

Nom de la nouvelle entrée.

schemaClassName

String

Nom du schéma utilisé pour la nouvelle entrée.

Retours

DirectoryEntry

Objet DirectoryEntry représentant la nouvelle entrée.

Exceptions

COMException

Une erreur s’est produite lors de l’appel d’une interface sous-jacente.

Exemples

L’exemple Visual Basic .NET suivant crée un DirectoryEntry objet avec un chemin spécifié, puis crée une entrée dans le conteneur et l’enregistre.

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’exemple C# suivant crée un DirectoryEntry objet avec un chemin spécifié, puis crée une entrée dans le conteneur et l’enregistre.

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’exemple C++ suivant crée un DirectoryEntry objet avec un chemin d’accès spécifié, puis crée une entrée dans le conteneur et l’enregistre.

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

Remarques

Vous devez appeler la CommitChanges méthode sur la nouvelle entrée pour rendre la création permanente. Lorsque vous appelez cette méthode, vous pouvez ensuite définir des valeurs de propriété obligatoires sur la nouvelle entrée. Les fournisseurs ont chacun des exigences différentes pour les propriétés qui doivent être définies avant qu’un appel à la CommitChanges méthode soit effectué. Si ces exigences ne sont pas remplies, le fournisseur peut lever une exception. Vérifiez auprès de votre fournisseur pour déterminer quelles propriétés doivent être définies avant de valider les modifications.