DirectoryEntries.Remove(DirectoryEntry) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Deletes a member of this collection.
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)
Parameters
- entry
- DirectoryEntry
The name of the DirectoryEntry object to delete.
Exceptions
An error occurred during the call to the underlying interface.
Examples
The following Visual Basic .NET example creates a new DirectoryEntry object with the specified path, then creates a new entry in the container and saves it. Finally, it retrieves the new entry and deletes it.
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
The following C# example creates a new DirectoryEntry object with the specified path, then creates a new entry in the container and saves it. Finally, it retrieves the new entry and deletes it.
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);
}
}
}
The following C++ example creates a new DirectoryEntry object with the specified path, then creates a new entry in the container and saves it. Finally, it retrieves the new entry and deletes it.
#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);
}
}
Remarks
If the entry to be removed is a container, the container must be empty. To delete a container and all its children, use the DeleteTree method.
Applies to
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈