PropertyCollection.System.Collections.IDictionary.Remove メソッド

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

PropertyCollection.System.Collections.IDictionary.Remove メソッド

指定したキーを持つ要素を IDictionary オブジェクトから削除します。

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

Visual Basic (宣言)

Private Sub System.Collections.IDictionary.Remove
 ( _
    key As Object _
) Implements IDictionary.Remove

Visual Basic (使用法)

Dim instance As PropertyCollection
Dim key As Object

CType(instance, IDictionary).Remove(key)

C#

void IDictionary.Remove (
    Object key
)

C++

private:
virtual void System.Collections.IDictionary.Remove (
    Object^ key
) sealed = IDictionary::Remove

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

key

削除する要素のキー。

例外

例外の種類	条件
ArgumentNullException	key が null 参照 (Visual Basic では Nothing) です。
NotSupportedException	IDictionary が読み取り専用です。 または IDictionary が固定サイズです。

使用例

Remove メソッドを実装する方法の例を次に示します。このコード例は、IDictionary クラスのトピックで取り上げているコード例の一部です。

Visual Basic

Public Sub Remove(ByVal
 key As Object) Implements
 IDictionary.Remove
    If key = Nothing Then
        Throw New ArgumentNullException("key")
    End If
    ' Try to find the key in the DictionaryEntry array
    Dim index As Integer
    If TryGetIndexOfKey(key, index) Then

        ' If the key is found, slide all the items up.
        Array.Copy(items, index + 1, items, index, (ItemsInUse - index) - 1)
        ItemsInUse = ItemsInUse - 1
    Else

        ' If the key is not in the dictionary, just return. 
    End If
End Sub

C#

public void Remove(object key)
{
    if (key == null) throw new
 ArgumentNullException("key");
    // Try to find the key in the DictionaryEntry array
    Int32 index;
    if (TryGetIndexOfKey(key, out index))
    {
        // If the key is found, slide all the items up.
        Array.Copy(items, index + 1, items, index, ItemsInUse - index - 1);
        ItemsInUse--;
    } 
    else
    {
        // If the key is not in the dictionary, just return. 
    }
}

C++

public:
    virtual void Remove(Object^ key)
    {
        if (key == nullptr)
        {
            throw gcnew ArgumentNullException("key");
        }
        // Try to find the key in the DictionaryEntry array
        int index;
        if (TryGetIndexOfKey(key, &index))
        {
            // If the key is found, slide all the items down.
            Array::Copy(items, index + 1, items, index, itemsInUse -
                index - 1);
            itemsInUse--;
        }
        else
        {
            // If the key is not in the dictionary, just return.
            return;
        }
    }

プラットフォーム

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

参照

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