DirectoryEntries.Remove(DirectoryEntry) Methode

Definition

Namespace:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll

Löscht ein Element 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 DirectoryEntry zu löschenden Objekts.

Ausnahmen

COMException

Fehler beim Aufruf der zugrunde liegenden Schnittstelle.

Beispiele

Im folgenden Beispiel wird ein neues DirectoryEntry Objekt mit dem angegebenen Pfad erstellt und anschließend ein neuer Eintrag im Container erstellt und gespeichert. Schließlich wird der neue Eintrag abgerufen und gelöscht.

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

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

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.

Gilt für: