DirectoryEntries.Add(String, String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u een nieuwe vermelding in de container.
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.DirectoryEntryPublic Function Add (name As String, schemaClassName As String) As DirectoryEntryParameters
- name
- String
De naam van het nieuwe item.
- schemaClassName
- String
De naam van het schema dat wordt gebruikt voor de nieuwe vermelding.
Retouren
Een DirectoryEntry object dat de nieuwe vermelding vertegenwoordigt.
Uitzonderingen
Er is een fout opgetreden tijdens het aanroepen van de onderliggende interface.
Voorbeelden
In het volgende voorbeeld wordt een nieuw DirectoryEntry object met een opgegeven pad gemaakt en wordt vervolgens een nieuwe vermelding in de container gemaakt en opgeslagen.
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.")
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.");
Opmerkingen
U moet de CommitChanges methode voor de nieuwe vermelding aanroepen om het maken permanent te maken. Wanneer u deze methode aanroept, kunt u vervolgens verplichte eigenschapswaarden instellen voor de nieuwe vermelding. De providers hebben elk verschillende vereisten voor eigenschappen die moeten worden ingesteld voordat een aanroep naar de CommitChanges methode wordt gedaan. Als niet aan deze vereisten wordt voldaan, kan de provider een uitzondering genereren. Neem contact op met uw provider om te bepalen welke eigenschappen moeten worden ingesteld voordat u wijzigingen doorvoert.
