DirectoryEntries.Add(String, String) Metoda

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

Návraty

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

Výjimky

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.

Platí pro