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


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

Определение

Перегрузки

Имя Описание
Remove(TKey)

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

Remove(TKey, TValue)

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

Remove(TKey)

Исходный код:
Dictionary.cs
Исходный код:
Dictionary.cs
Исходный код:
Dictionary.cs
Исходный код:
Dictionary.cs
Исходный код:
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

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

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

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

Реализации

Исключения

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.
printfn "\nRemove(\"doc\")"
openWith.Remove "doc" |> ignore

if openWith.ContainsKey "doc" |> not then
    printfn "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> . Это не означает безопасность потоков.

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

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

Remove(TKey, TValue)

Исходный код:
Dictionary.cs
Исходный код:
Dictionary.cs
Исходный код:
Dictionary.cs
Исходный код:
Dictionary.cs
Исходный код:
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

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

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

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

Исключения

key равно null.

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