IDictionary<TKey,TValue>.Remove(TKey) Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Runtime.dll

Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary<TKey,TValue>.

public:
 bool Remove(TKey key);

public bool Remove (TKey key);

abstract member 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 erfolgreich entfernt wurde, andernfalls false. Diese Methode gibt auch dann false zurück, wenn key nicht im ursprünglichen IDictionary<TKey,TValue> gefunden wurde.

Ausnahmen

ArgumentNullException

key ist null.

NotSupportedException

IDictionary<TKey,TValue> ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie mithilfe der Remove -Methode ein Schlüssel-Wert-Paar aus einem Wörterbuch entfernen.

Dieser Code ist Teil eines größeren Beispiels, das kompiliert und ausgeführt werden kann. Siehe System.Collections.Generic.IDictionary<TKey,TValue>.

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

Implementierungen können in der Art und Weise variieren, wie sie die Gleichheit von Objekten bestimmen. Beispielsweise verwendet Comparer<T>.Defaultdie List<T> -Klasse , während die Dictionary<TKey,TValue> -Klasse es dem Benutzer ermöglicht, die Implementierung anzugeben, die IComparer<T> zum Vergleichen von Schlüsseln verwendet werden soll.

Weitere Informationen

• IsReadOnly