Dictionary<TKey,TValue>.Remove Dictionary<TKey,TValue>.Remove Dictionary<TKey,TValue>.Remove Dictionary<TKey,TValue>.Remove Method

Определение

Перегрузки

Remove(TKey) Remove(TKey) Remove(TKey) Remove(TKey)

Удаляет значение с указанным ключом из Dictionary<TKey,TValue>.Removes the value with the specified key from the Dictionary<TKey,TValue>.

Remove(TKey, TValue) Remove(TKey, TValue) Remove(TKey, TValue) Remove(TKey, TValue)

Remove(TKey) Remove(TKey) Remove(TKey) Remove(TKey)

Удаляет значение с указанным ключом из Dictionary<TKey,TValue>.Removes the value with the specified key from the 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 TKey TKey TKey

Ключ элемента, который требуется удалить.The key of the element to remove.

Возвраты

Значение true, если элемент был найден и удален; в противном случае — значение false.true if the element is successfully found and removed; otherwise, false. Этот метод возвращает значение false, если ключ key не удалось найти в Dictionary<TKey,TValue>.This method returns false if key is not found in the Dictionary<TKey,TValue>.

Реализации

Исключения

Свойство key имеет значение null.key is null.

Примеры

В следующем примере кода показано, как удалить пару ключ/значение из словаря с помощью Remove метод.The following code example shows how to remove a key/value pair from a dictionary using the Remove method.

Данный пример кода является частью большего примера для Dictionary<TKey,TValue> класс (openWith имя словарь, используемый в этом примере).This code example is part of a larger example provided for the Dictionary<TKey,TValue> class (openWith is the name of the Dictionary used in this example).

// 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> остается неизменным.If the Dictionary<TKey,TValue> does not contain an element with the specified key, the Dictionary<TKey,TValue> remains unchanged. Исключение не возникает.No exception is thrown.

Этот метод приближается к операцией o(1).This method approaches an O(1) operation.

Дополнительно

Remove(TKey, TValue) Remove(TKey, TValue) Remove(TKey, TValue) Remove(TKey, TValue)

public:
 bool Remove(TKey key, [Runtime::InteropServices::Out] TValue % value);
public bool Remove (TKey key, out TValue value);
member this.Remove : 'Key *  -> bool
Public Function Remove (key As TKey, ByRef value As TValue) As Boolean

Параметры

key
TKey TKey TKey TKey
value
TValue TValue TValue TValue

Возвраты

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