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 value parametru.Removes the value with the specified key from the Dictionary<TKey,TValue>, and copies the element to the value parameter.

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

Boolean

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

Boolean

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.

Platí pro