Dictionary<TKey,TValue>.Remove Metoda
Definice
Přetížení
Remove(TKey) |
Odebere hodnotu se zadaným klíčem z Dictionary<TKey,TValue> .Removes the value with the specified key from the Dictionary<TKey,TValue>. |
Remove(TKey, TValue) |
Odebere hodnotu se zadaným klíčem z Dictionary<TKey,TValue> a zkopíruje prvek do |
Remove(TKey)
Odebere hodnotu se zadaným klíčem z 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
Parametry
- key
- TKey
Klíč elementu, který se má odebratThe key of the element to remove.
Návraty
true
Pokud byl prvek úspěšně nalezen a odebrán; v opačném případě false
.true
if the element is successfully found and removed; otherwise, false
. Tato metoda vrátí, false
Pokud key
není nalezena v Dictionary<TKey,TValue> .This method returns false
if key
is not found in the Dictionary<TKey,TValue>.
Implementuje
Výjimky
key
je null
.key
is null
.
Příklady
Následující příklad kódu ukazuje, jak odebrat dvojici klíč/hodnota ze slovníku pomocí Remove metody.The following code example shows how to remove a key/value pair from a dictionary using the Remove method.
Tento příklad kódu je součástí většího příkladu, který je k dispozici pro Dictionary<TKey,TValue> třídu ( openWith
je název slovníku používaného v tomto příkladu).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
Poznámky
Pokud neobsahuje Dictionary<TKey,TValue> prvek se zadaným klíčem, Dictionary<TKey,TValue> zůstane beze změny.If the Dictionary<TKey,TValue> does not contain an element with the specified key, the Dictionary<TKey,TValue> remains unchanged. Žádná výjimka se nevyvolá.No exception is thrown.
Tato metoda přistupuje k operaci O (1).This method approaches an O(1) operation.
Pouze .NET Core 3.0 +: tuto metodu, kterou je možné provést, lze bezpečně volat bez zrušení platnosti aktivních enumerátorů v Dictionary<TKey,TValue> instanci..NET Core 3.0+ only: this mutating method may be safely called without invalidating active enumerators on the Dictionary<TKey,TValue> instance. To neznamená bezpečnost vlákna.This does not imply thread safety.
Viz také
Platí pro
Remove(TKey, TValue)
Odebere hodnotu se zadaným klíčem z Dictionary<TKey,TValue> a zkopíruje prvek do value
parametru.Removes the value with the specified key from the Dictionary<TKey,TValue>, and copies the element to the value
parameter.
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
Parametry
- key
- TKey
Klíč elementu, který se má odebratThe key of the element to remove.
- value
- TValue
Odebraný element.The removed element.
Návraty
true
Pokud byl prvek úspěšně nalezen a odebrán; v opačném případě false
.true
if the element is successfully found and removed; otherwise, false
.
Výjimky
key
je null
.key
is null
.