Dictionary<TKey,TValue>.Remove Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| Remove(TKey) |
Удаляет значение с указанным ключом Dictionary<TKey,TValue>из . |
| Remove(TKey, TValue) |
Удаляет значение с указанным ключом из Dictionary<TKey,TValue>элемента и копирует его в |
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.