Dictionary<TKey,TValue>.Remove Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Überlädt

Remove(TKey)	Entfernt den Wert mit dem angegebenen Schlüssel aus dem Dictionary<TKey,TValue>.
Remove(TKey, TValue)	Entfernt den Wert mit dem angegebenen Schlüssel aus Dictionary<TKey,TValue> und kopiert das Element in den value-Parameter.

Remove(TKey)

Quelle:

Dictionary.cs

Entfernt den Wert mit dem angegebenen Schlüssel aus dem 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

Parameter

key

TKey

Der Schlüssel des zu entfernenden Elements.

Gibt zurück

Boolean

true, wenn das Element gefunden und entfernt wurde, andernfalls false. Diese Methode gibt auch dann false zurück, wenn key nicht im ursprünglichen Dictionary<TKey,TValue> gefunden wurde.

Implementiert

Remove(TKey)

Ausnahmen

ArgumentNullException

key ist null.

Beispiele

Das folgende Codebeispiel zeigt, wie ein Schlüssel-Wert-Paar mithilfe der Remove -Methode aus einem Wörterbuch entfernt wird.

Dieses Codebeispiel ist Teil eines größeren Beispiels für die Dictionary<TKey,TValue> -Klasse (openWith ist der Name des in diesem Beispiel verwendeten Wörterbuchs).

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

Hinweise

Wenn das Dictionary<TKey,TValue> kein Element mit dem angegebenen Schlüssel enthält, bleibt der Dictionary<TKey,TValue> unverändert. Es wird keine Ausnahme ausgelöst.

Diese Methode nähert sich einem O(1)-Vorgang.

Nur .NET Core 3.0 und höher: Diese mutierende Methode kann sicher aufgerufen werden, ohne aktive Enumeratoren auf dem Dictionary<TKey,TValue> instance ungültig zu werden. Dies bedeutet nicht die Threadsicherheit.

Weitere Informationen

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

Remove(TKey, TValue)

Quelle:

Dictionary.cs

Entfernt den Wert mit dem angegebenen Schlüssel aus Dictionary<TKey,TValue> und kopiert das Element in den 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

Parameter

key

TKey

Der Schlüssel des zu entfernenden Elements.

value

TValue

Das entfernte Element.

Gibt zurück

Boolean

true, wenn das Element gefunden und entfernt wurde, andernfalls false.

Ausnahmen

ArgumentNullException

key ist null.