Freigeben über


Dictionary<TKey,TValue>.Remove Methode

Definition

Ü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
Quelle:
Dictionary.cs
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

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

Ausnahmen

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

Gilt für:

Remove(TKey, TValue)

Quelle:
Dictionary.cs
Quelle:
Dictionary.cs
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

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

Ausnahmen

key ist null.

Gilt für: