OrderedDictionary.Remove(Object) Metoda

Definice

Obor názvů:

System.Collections.Specialized

Sestavení:

System.Collections.Specialized.dll

Zdroj:

OrderedDictionary.cs

Odebere položku se zadaným klíčem z OrderedDictionary kolekce.

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)

Parametry

key

Object

Klíč položky, která se má odebrat.

Implementuje

Remove(Object)

Výjimky

NotSupportedException

Kolekce OrderedDictionary je jen pro čtení.

ArgumentNullException

key je null.

Příklady

Následující příklad kódu ukazuje úpravu OrderedDictionary kolekce. V tomto příkladu Remove se metoda používá k odebrání položky s klíčem "keyToDelete" z objektu OrderedDictionary. Tento kód je součástí většího příkladu kódu, který lze zobrazit na adrese 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

Poznámky

Položky, které následují za odebranou položkou, se přesunou nahoru, aby zabíraly uvolněné místo, a indexy položek, které se přesouvají, se také aktualizují.

OrderedDictionary Pokud kolekce neobsahuje položku se zadaným klíčem, OrderedDictionary zůstane beze změny a nevyvolá se žádná výjimka.