Dictionary<TKey,TValue>.Remove Metoda

Definice

Obor názvů:

System.Collections.Generic

Sestavení:

System.Collections.dll

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)

Zdroj:

Dictionary.cs

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

Boolean

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

Remove(TKey)

Výjimky

ArgumentNullException

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

• Add(TKey, TValue)
• Remove(TKey)

Remove(TKey, TValue)

Zdroj:

Dictionary.cs

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

Boolean

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

Výjimky

ArgumentNullException

key je null.