OrderedDictionary.Remove(Object) メソッド

定義

名前空間:

System.Collections.Specialized

アセンブリ:

System.dll, System.Collections.Specialized.dll

アセンブリ:

System.Collections.Specialized.dll

アセンブリ:

System.dll

アセンブリ:

netstandard.dll

指定したキーを持つエントリを OrderedDictionary コレクションから削除します。

public:
 virtual void Remove(System::Object ^ key);

public void Remove (object key);

abstract member Remove : obj -> unit
override this.Remove : obj -> unit

Public Sub Remove (key As Object)

パラメーター

key

Object

削除するエントリのキー。

実装

Remove(Object)

例外

NotSupportedException

OrderedDictionary コレクションは読み取り専用です。

ArgumentNullException

key が nullです。

例

次のコード例は、コレクションの変更を OrderedDictionary 示しています。 この例では、メソッドを Remove 使用して、キー "keyToDelete" を持つエントリを削除します OrderedDictionary。 このコードは、表示できるより大きなコード例の一部です OrderedDictionary。

// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary->Contains("keyToDelete"))
    {
        myOrderedDictionary->Remove("keyToDelete");
    }
}

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

注釈

削除されたエントリの後に続くエントリは、空の場所を占有するために上に移動し、移動するエントリのインデックスも更新されます。

指定したキーを OrderedDictionary 持つエントリがコレクションに含まれていない場合、 OrderedDictionary その値は変更されず、例外はスローされません。