DirectoryEntries.Remove(DirectoryEntry) Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

DirectoryEntries.cs

Löscht einen Member dieser Auflistung.

public:
 void Remove(System::DirectoryServices::DirectoryEntry ^ entry);

public void Remove (System.DirectoryServices.DirectoryEntry entry);

member this.Remove : System.DirectoryServices.DirectoryEntry -> unit

Public Sub Remove (entry As DirectoryEntry)

Parameter

entry

DirectoryEntry

Der Name des zu löschenden DirectoryEntry-Objekts.

Ausnahmen

COMException

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.

Beispiele

Im folgenden Visual Basic .NET-Beispiel wird ein neues DirectoryEntry -Objekt mit dem angegebenen Pfad erstellt, anschließend ein neuer Eintrag im Container erstellt und gespeichert. Schließlich ruft er den neuen Eintrag ab und löscht ihn.

Imports System  
Imports System.DirectoryServices  

Class MyClass1  
   Shared Sub Main()  
      Try  
         Dim strPath As String = "IIS://localhost/W3SVC/1/Root"  
         Dim strName As String = ""  

         ' 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("Sample", myDE.SchemaClassName)  
         ' Save changes of entry in the 'Active Directory Domain Services'.  
         myDirectoryEntry.CommitChanges()  
         Console.WriteLine(myDirectoryEntry.Name + " entry is created in container.")  

         ' Find 'Sample' entry in container.  
         myDirectoryEntry = myEntries.Find("Sample", myDE.SchemaClassName)  
         Console.WriteLine(myDirectoryEntry.Name + " found in container.")  
         ' Remove 'Sample' entry from container.  
         strName = myDirectoryEntry.Name  
         myEntries.Remove(myDirectoryEntry)  
         Console.WriteLine(strName + " entry is removed from container.")  

      Catch e As Exception  
         Console.WriteLine("The following exception was raised : {0}", e.Message.ToString())  
      End Try  
   End Sub 'Main  
End Class 'MyClass1  

Im folgenden C#-Beispiel wird ein neues DirectoryEntry Objekt mit dem angegebenen Pfad erstellt, anschließend ein neuer Eintrag im Container erstellt und gespeichert. Schließlich ruft er den neuen Eintrag ab und löscht ihn.

using System;  
using System.DirectoryServices;   

class MyClass1  
{  
   static void Main()  
   {  
      try  
      {  
         String strPath = "IIS://localhost/W3SVC/1/Root";  
         String strName = "";  

         // 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("Sample", myDE.SchemaClassName);  
         // Save changes of entry in the 'Active Directory Domain Services'.  
         myDirectoryEntry.CommitChanges();  
         Console.WriteLine (myDirectoryEntry.Name +   
            " entry is created in container.");  

         // Find 'Sample' entry in container.  
         myDirectoryEntry = myEntries.Find("Sample", myDE.SchemaClassName);  
         Console.WriteLine(myDirectoryEntry.Name + " found in container.");  
         // Remove 'Sample' entry from container.  
         strName = myDirectoryEntry.Name;  
         myEntries.Remove(myDirectoryEntry);  
         Console.WriteLine(strName+ " entry is removed from container.");  

      }  
      catch(Exception e)  
      {  
         Console.WriteLine("The following exception was raised : {0}",  
            e.Message);  
      }  
   }  
}  

Im folgenden C++-Beispiel wird ein neues DirectoryEntry -Objekt mit dem angegebenen Pfad erstellt, dann ein neuer Eintrag im Container erstellt und gespeichert. Schließlich ruft er den neuen Eintrag ab und löscht ihn.

#using <mscorlib.dll>  
#using <System.dll>  
#using <System.Directoryservices.dll>  

using namespace System;  
using namespace System::DirectoryServices;   

int main() {  
    try {  
        String* strPath = S"IIS://localhost/W3SVC/1/Root";  
        String* strName = S"";  

        // 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"Sample", myDE->SchemaClassName);  
        // Save changes of entry in the 'Active Directory Domain Services'.  
        myDirectoryEntry->CommitChanges();  
        Console::WriteLine(S"{0} entry is created in container.", myDirectoryEntry->Name);  

        // Find 'Sample' entry in container.  
        myDirectoryEntry = myEntries->Find(S"Sample", myDE->SchemaClassName);  
        Console::WriteLine(S"{0} found in container.", myDirectoryEntry->Name);  
        // Remove 'Sample' entry from container.  
        strName = myDirectoryEntry->Name;  
        myEntries->Remove(myDirectoryEntry);  
        Console::WriteLine(S"{0} entry is removed from container.", strName);  
    } catch(Exception* e) {  
        Console::WriteLine(S"The following exception was raised : {0}", e->Message);  
    }  
}  

Hinweise

Wenn der zu entfernende Eintrag ein Container ist, muss der Container leer sein. Verwenden Sie die DeleteTree -Methode, um einen Container und alle untergeordneten Elemente zu löschen.