Dictionary<TKey,TValue>.Remove Metoda

Definice

Přetížení

Remove(TKey)

Odebere hodnotu se zadaným klíčem z objektu Dictionary<TKey,TValue>.

Remove(TKey, TValue)

Odebere hodnotu se zadaným klíčem z Dictionary<TKey,TValue>a zkopíruje element do parametru value .

Remove(TKey)

Odebere hodnotu se zadaným klíčem z objektu 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íč prvku, který chcete odebrat.

Návraty

truepokud je prvek úspěšně nalezen a odebrán; v opačném případě . false Tato metoda vrátí false , pokud key není nalezen v Dictionary<TKey,TValue>.

Implementuje

Výjimky

key je null.

Příklady

Následující příklad kódu ukazuje, jak odebrat pár klíč/hodnota ze slovníku Remove pomocí metody .

Tento příklad kódu je součástí většího příkladu poskytnutého Dictionary<TKey,TValue> pro třídu (openWith je název slovníku použitého v tomto příkladu).

// 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

Dictionary<TKey,TValue> Pokud objekt neobsahuje prvek se zadaným klíčem, Dictionary<TKey,TValue> zůstane beze změny. Žádná výjimka se nevyvolá.

Tato metoda se blíží operaci O(1).

Pouze .NET Core 3.0+: Tuto metodu mutování je možné bezpečně volat bez zneplatnění aktivních výčtů v Dictionary<TKey,TValue> instanci. To neznamená bezpečnost vláken.

Viz také

Platí pro

Remove(TKey, TValue)

Odebere hodnotu se zadaným klíčem z Dictionary<TKey,TValue>a zkopíruje element do parametru 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

Parametry

key
TKey

Klíč prvku, který chcete odebrat.

value
TValue

Odebraný prvek

Návraty

truepokud je prvek úspěšně nalezen a odebrán; v opačném případě . false

Výjimky

key je null.

Platí pro