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

Definition

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

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

key ist null.

Beispiele

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

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 variieren, wie sie die Gleichheit von Objekten bestimmen. Beispielsweise verwendet Comparer<T>.Defaultdie List<T> -Klasse , während die Dictionary<TKey,TValue> -Klasse dem Benutzer ermöglicht, die Implementierung anzugeben, die zum Vergleichen von IComparer<T> Schlüsseln verwendet werden soll.

Gilt für:

Weitere Informationen