Freigeben über


Dictionary<TKey,TValue>.Remove Methode

Definition

Überlädt

Name Beschreibung
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 dem Dictionary<TKey,TValue>, und kopiert das Element in den value Parameter.

Remove(TKey)

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

truewenn das Element erfolgreich gefunden und entfernt wurde; andernfalls . false Diese Methode gibt zurück false , wenn key in der Dictionary<TKey,TValue>.

Implementiert

Ausnahmen

key ist null.

Beispiele

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

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Dictionary<TKey,TValue> Klasse bereitgestellt wird (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.
printfn "\nRemove(\"doc\")"
openWith.Remove "doc" |> ignore

if openWith.ContainsKey "doc" |> not then
    printfn "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> Element mit dem angegebenen Schlüssel nicht enthalten ist, bleibt dies Dictionary<TKey,TValue> unverändert. Es wird keine Ausnahme ausgelöst.

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

.NET Core 3.0+ nur: Diese Mutating-Methode kann ohne ungültige aktive Enumerationen für die Dictionary<TKey,TValue> Instanz sicher aufgerufen werden. Dies impliziert keine Threadsicherheit.

Weitere Informationen

Gilt für:

Remove(TKey, TValue)

Quelle:
Dictionary.cs
Quelle:
Dictionary.cs
Quelle:
Dictionary.cs
Quelle:
Dictionary.cs
Quelle:
Dictionary.cs

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

truewenn das Element erfolgreich gefunden und entfernt wurde; andernfalls . false

Ausnahmen

key ist null.

Gilt für: