IDictionary.Remove(Object) Метод

Определение

Пространство имен:

System.Collections

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

IDictionary.cs

Удаляет элемент с указанным ключом из IDictionary объекта.

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

public void Remove(object key);

abstract member Remove : obj -> unit

Public Sub Remove (key As Object)

Параметры

key

Object

Ключ удаляемого элемента.

Исключения

ArgumentNullException

key равно null.

NotSupportedException

Объект IDictionary доступен только для чтения.

–или–

Имеет IDictionary фиксированный размер.

Примеры

В следующем примере кода показано, как реализовать Remove метод. Этот пример кода является частью более крупного примера, предоставленного для IDictionary класса.

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

Комментарии

IDictionary Если объект не содержит элемент с указанным ключом, остается IDictionary неизменным. Исключение не возникает.