DirectoryEntries.Add(String, String) Metoda

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

DirectoryEntries.cs

Vytvoří novou položku v kontejneru.

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

Parametry

name

String

Název nové položky.

schemaClassName

String

Název schématu, který se použije pro novou položku.

Návraty

DirectoryEntry

Objekt DirectoryEntry , který představuje novou položku.

Výjimky

COMException

Během volání základního rozhraní došlo k chybě.

Příklady

Následující příklad jazyka Visual Basic .NET vytvoří nový DirectoryEntry objekt se zadanou cestou, pak vytvoří novou položku v kontejneru a uloží ji.

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

Následující příklad jazyka C# vytvoří nový DirectoryEntry objekt se zadanou cestou, pak vytvoří novou položku v kontejneru a uloží ji.

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

Následující příklad jazyka C++ vytvoří nový DirectoryEntry objekt se zadanou cestou, pak vytvoří novou položku v kontejneru a uloží ji.

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

Poznámky

Pro novou položku je nutné volat CommitChanges metodu , aby vytvoření bylo trvalé. Při volání této metody pak můžete u nové položky nastavit povinné hodnoty vlastností. Zprostředkovatelé mají různé požadavky na vlastnosti, které je třeba nastavit před voláním CommitChanges metody. Pokud tyto požadavky nejsou splněny, může poskytovatel vyvolat výjimku. Před potvrzením změn se obraťte na svého poskytovatele a zjistěte, které vlastnosti je potřeba nastavit.