Dictionary<TKey,TValue>.Remove Метод

Определение

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

System.Collections.Generic

Сборка:

System.Collections.dll

Перегрузки

Remove(TKey)	Удаляет значение с указанным ключом из словаря Dictionary<TKey,TValue>.
Remove(TKey, TValue)	Удаляет значение с указанным ключом из объекта Dictionary<TKey,TValue> и копирует элемент в параметр value.

Remove(TKey)

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

Dictionary.cs

Удаляет значение с указанным ключом из словаря Dictionary<TKey,TValue>.

public:
 virtual bool Remove(TKey key);

public bool Remove (TKey key);

abstract member Remove : 'Key -> bool
override this.Remove : 'Key -> bool

Public Function Remove (key As TKey) As Boolean

Параметры

key

TKey

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

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

Boolean

Значение true, если элемент был найден и удален; в противном случае — значение false. Этот метод возвращает значение false, если ключ key не удалось найти в Dictionary<TKey,TValue>.

Реализации

Remove(TKey)

Исключения

ArgumentNullException

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

Примеры

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

Этот пример кода является частью более крупного примера, предоставленного Dictionary<TKey,TValue> для класса (openWith — это имя словаря, используемого в этом примере).

// 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.");
}

// 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.");
}

' Use the Remove method to remove a key/value pair.
Console.WriteLine(vbLf + "Remove(""doc"")")
openWith.Remove("doc")

If Not openWith.ContainsKey("doc") Then
    Console.WriteLine("Key ""doc"" is not found.")
End If

Комментарии

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

Этот метод подходит к операции O(1).

Только для .NET Core 3.0 и более поздних версий: этот метод можно безопасно вызывать без аннулирования активных перечислителей в экземпляре Dictionary<TKey,TValue> . Это не подразумевает потокобезопасность.

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

• Add(TKey, TValue)
• Remove(TKey)

Remove(TKey, TValue)

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

Dictionary.cs

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

public:
 bool Remove(TKey key, [Runtime::InteropServices::Out] TValue % value);

public bool Remove (TKey key, out TValue value);

member this.Remove : 'Key * 'Value -> bool

Public Function Remove (key As TKey, ByRef value As TValue) As Boolean

Параметры

key

TKey

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

value

TValue

Удаленный элемент.

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

Boolean

Значение true, если элемент был найден и удален; в противном случае — значение false.

Исключения

ArgumentNullException

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