Прочитать на английском

Поделиться через


IDictionary<TKey,TValue>.Remove(TKey) Метод

Определение

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

public bool Remove (TKey key);

Параметры

key
TKey

Ключ элемента, который требуется удалить.

Возвращаемое значение

Значение true, если элемент успешно удален; в противном случае — значение false. Этот метод также возвращает false, если объект key не был найден в исходной коллекции IDictionary<TKey,TValue>.

Исключения

key имеет значение null.

Объект IDictionary<TKey,TValue> доступен только для чтения.

Примеры

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

Этот код является частью более крупного примера, который можно скомпилировать и выполнить. См. раздел System.Collections.Generic.IDictionary<TKey,TValue>.

// Use the Remove method to remove a key/value pair.
Console.WriteLine("\nRemove(\"doc\")");
openWith.Remove("doc");

if (!openWith.ContainsKey("doc"))
{
    Console.WriteLine("Key \"doc\" is not found.");
}

Комментарии

Реализации могут различаться в зависимости от того, как они определяют равенство объектов; Например, List<T> класс использует Comparer<T>.Default, тогда как Dictionary<TKey,TValue> класс позволяет пользователю указать реализацию, используемую IComparer<T> для сравнения ключей.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел