IDictionary.Remove(Object) Metod

Definition

Namnområde:
System.Collections
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
netstandard.dll

Tar bort elementet med den angivna nyckeln från IDictionary objektet.

public:
 void Remove(System::Object ^ key);
public void Remove(object key);
abstract member Remove : obj -> unit
Public Sub Remove (key As Object)

Parametrar

key
Object

Nyckeln för elementet som ska tas bort.

Undantag

ArgumentNullException

key är null.

NotSupportedException

Objektet IDictionary är skrivskyddat.

-eller-

Har IDictionary en fast storlek.

Exempel

Följande kodexempel visar hur du implementerar Remove metoden. Det här kodexemplet är en del av ett större exempel för IDictionary klassen.

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

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

Kommentarer

Om objektet IDictionary inte innehåller ett element med den angivna nyckeln förblir det IDictionary oförändrat. Inget undantag kastas.

Gäller för