Dictionary<TKey,TValue>.Remove Metoda

Definicja

Przestrzeń nazw:

System.Collections.Generic

Zestaw:

System.Collections.dll

Przeciążenia

Remove(TKey)	Usuwa wartość z określonego klucza z elementu Dictionary<TKey,TValue>.
Remove(TKey, TValue)	Usuwa wartość z określonego klucza z Dictionary<TKey,TValue>elementu i kopiuje element do parametru value .

Remove(TKey)

Źródło:

Dictionary.cs

Usuwa wartość z określonego klucza z elementu 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

Parametry

key

TKey

Klucz elementu do usunięcia.

Zwraca

Boolean

true jeśli element został pomyślnie znaleziony i usunięty; w przeciwnym razie , false. Ta metoda zwraca wartość false , jeśli key nie zostanie znaleziona w obiekcie Dictionary<TKey,TValue>.

Implementuje

Remove(TKey)

Wyjątki

ArgumentNullException

key to null.

Przykłady

Poniższy przykład kodu pokazuje, jak usunąć parę klucz/wartość ze słownika przy użyciu Remove metody .

Ten przykład kodu jest częścią większego przykładu podanego Dictionary<TKey,TValue> dla klasy (openWith jest nazwą słownika używanego w tym przykładzie).

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

Uwagi

Jeśli element Dictionary<TKey,TValue> nie zawiera elementu z określonym kluczem, Dictionary<TKey,TValue> pozostaje niezmieniony. Wyjątek nie jest zgłaszany.

Ta metoda zbliża się do operacji O(1).

Tylko .NET Core 3.0+ : ta metoda mutowania może być bezpiecznie wywoływana bez unieważniania aktywnych modułów wyliczających w wystąpieniu Dictionary<TKey,TValue> . Nie oznacza to bezpieczeństwa wątków.

Zobacz też

• Add(TKey, TValue)
• Remove(TKey)

Remove(TKey, TValue)

Źródło:

Dictionary.cs

Usuwa wartość z określonego klucza z Dictionary<TKey,TValue>elementu i kopiuje element do parametru 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

Parametry

key

TKey

Klucz elementu do usunięcia.

value

TValue

Usunięty element.

Zwraca

Boolean

true jeśli element został pomyślnie znaleziony i usunięty; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

key to null.