Udostępnij za pośrednictwem


Dictionary<TKey,TValue>.Remove Metoda

Definicja

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
Źródło:
Dictionary.cs
Ź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

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

Wyjątki

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ż

Dotyczy

Remove(TKey, TValue)

Źródło:
Dictionary.cs
Źródło:
Dictionary.cs
Ź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

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

Wyjątki

key to null.

Dotyczy