DirectoryEntries.Add(String, String) Metod

Definition

Namnområde:
System.DirectoryServices
Sammansättning:
System.DirectoryServices.dll

Skapar en ny post i containern.

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

Parametrar

name
String

Namnet på den nya posten.

schemaClassName
String

Namnet på schemat som används för den nya posten.

Returer

DirectoryEntry

Ett DirectoryEntry objekt som representerar den nya posten.

Undantag

COMException

Ett fel uppstod under anropet till det underliggande gränssnittet.

Exempel

I följande exempel skapas ett nytt DirectoryEntry objekt med en angiven sökväg och sedan skapas en ny post i containern och sparas.

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

Kommentarer

Du måste anropa CommitChanges metoden för den nya posten för att göra skapandet permanent. När du anropar den här metoden kan du sedan ange obligatoriska egenskapsvärden för den nya posten. Leverantörerna har olika krav för egenskaper som måste anges innan ett anrop till CommitChanges metoden görs. Om dessa krav inte uppfylls kan providern utlösa ett undantag. Kontakta leverantören för att avgöra vilka egenskaper som måste anges innan du genomför ändringar.

Gäller för