Dictionary<TKey,TValue>.Remove Metod

Definition

Överlagringar

Name Description
Remove(TKey)

Tar bort värdet med den angivna nyckeln från Dictionary<TKey,TValue>.

Remove(TKey, TValue)

Tar bort värdet med den angivna nyckeln från Dictionary<TKey,TValue>och kopierar elementet till parametern value .

Remove(TKey)

Tar bort värdet med den angivna nyckeln från 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

Parametrar

key
TKey

Nyckeln för elementet som ska tas bort.

Returer

trueom elementet har hittats och tagits bort. annars . false Den här metoden returnerar false om key det inte finns i Dictionary<TKey,TValue>.

Implementeringar

Undantag

key är null.

Exempel

I följande kodexempel visas hur du tar bort ett nyckel/värde-par från en ordlista med hjälp av Remove metoden.

Det här kodexemplet är en del av ett större exempel för Dictionary<TKey,TValue> klassen (openWith är namnet på ordlistan som används i det här exemplet).

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

Kommentarer

Dictionary<TKey,TValue> Om inte innehåller ett element med den angivna nyckeln förblir den Dictionary<TKey,TValue> oförändrad. Inget undantag kastas.

Den här metoden närmar sig en O(1)-åtgärd.

endast .NET Core 3.0+ : Den här muterande metoden kan anropas på ett säkert sätt utan att aktiva uppräknare på instansen Dictionary<TKey,TValue> ogiltigförklaras. Detta innebär inte trådsäkerhet.

Se även

Gäller för

Remove(TKey, TValue)

Tar bort värdet med den angivna nyckeln från Dictionary<TKey,TValue>och kopierar elementet till parametern value .

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

Parametrar

key
TKey

Nyckeln för elementet som ska tas bort.

value
TValue

Det borttagna elementet.

Returer

trueom elementet har hittats och tagits bort. annars . false

Undantag

key är null.

Gäller för