DirectoryEntries.Remove メソッド

.NET Framework クラス ライブラリ リファレンス

DirectoryEntries.Remove メソッド

このコレクションのメンバを削除します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文

Visual Basic (宣言)

Public Sub Remove ( _
    entry As DirectoryEntry _
)

Visual Basic (使用法)

Dim instance As DirectoryEntries
Dim entry As DirectoryEntry

instance.Remove(entry)

C#

public void Remove (
    DirectoryEntry entry
)

C++

public:
void Remove (
    DirectoryEntry^ entry
)

J#

public void Remove (
    DirectoryEntry entry
)

JScript

public function Remove (
    entry : DirectoryEntry
)

パラメータ

entry

削除する DirectoryEntry オブジェクトの名前。

例外

例外の種類	条件
COMException	基になるインターフェイスを呼び出すときにエラーが発生しました。

解説

削除されるエントリがコンテナである場合、そのコンテナは空である必要があります。コンテナとそのすべての子を削除するには、DeleteTree メソッドを使用します。

使用例

指定したパスを持つ新しい DirectoryEntry オブジェクトを作成し、そのコンテナ内に新しいエントリを作成し、それを保存する Visual Basic .NET コード例を次に示します。最後に、新しいエントリを取得し、それを削除します。

Visual Basic

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'.
         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

指定したパスを持つ新しい DirectoryEntry オブジェクトを作成し、そのコンテナ内に新しいエントリを作成し、それを保存する C# コード例を次に示します。最後に、新しいエントリを取得し、それを削除します。

C#

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

指定したパスを持つ新しい DirectoryEntry オブジェクトを作成し、そのコンテナ内に新しいエントリを作成し、それを保存する C++ コード例を次に示します。最後に、新しいエントリを取得し、それを削除します。

C++

#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'.
        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);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DirectoryEntries クラス
DirectoryEntries メンバ
System.DirectoryServices 名前空間