Dictionary<TKey,TValue>.Remove Metoda

Definicja

Przeciążenia

Remove(TKey)

Usuwa wartość z określonym kluczem z Dictionary<TKey,TValue> .Removes the value with the specified key from the Dictionary<TKey,TValue>.

Remove(TKey, TValue)

Usuwa wartość z określonym kluczem z Dictionary<TKey,TValue> i kopiuje element do value parametru.Removes the value with the specified key from the Dictionary<TKey,TValue>, and copies the element to the value parameter.

Remove(TKey)

Usuwa wartość z określonym kluczem z Dictionary<TKey,TValue> .Removes the value with the specified key from the 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.The key of the element to remove.

Zwraca

Boolean

true Jeśli element zostanie pomyślnie znaleziony i usunięty; w przeciwnym razie false .true if the element is successfully found and removed; otherwise, false. Ta metoda zwraca false wartość key , jeśli nie została znaleziona w Dictionary<TKey,TValue> .This method returns false if key is not found in the Dictionary<TKey,TValue>.

Implementuje

Wyjątki

key to null.key is null.

Przykłady

Poniższy przykład kodu pokazuje, jak usunąć parę klucz/wartość ze słownika przy użyciu Remove metody.The following code example shows how to remove a key/value pair from a dictionary using the Remove method.

Ten przykład kodu jest częścią większego przykładu dostarczonego dla Dictionary<TKey,TValue> klasy ( openWith jest nazwą słownika użytego w tym przykładzie).This code example is part of a larger example provided for the Dictionary<TKey,TValue> class (openWith is the name of the Dictionary used in this example).

// 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 nie Dictionary<TKey,TValue> zawiera elementu z określonym kluczem, Dictionary<TKey,TValue> pozostaje niezmieniona.If the Dictionary<TKey,TValue> does not contain an element with the specified key, the Dictionary<TKey,TValue> remains unchanged. Wyjątek nie jest zgłaszany.No exception is thrown.

Ta metoda zbliża się do operacji O (1).This method approaches an O(1) operation.

Tylko platforma .NET Core 3.0: Ta metoda mutacji może być bezpiecznie wywoływana bez unieważniania aktywnych modułów wyliczających w Dictionary<TKey,TValue> wystąpieniu..NET Core 3.0+ only: this mutating method may be safely called without invalidating active enumerators on the Dictionary<TKey,TValue> instance. Nie oznacza to bezpieczeństwa wątków.This does not imply thread safety.

Zobacz też

Dotyczy

Remove(TKey, TValue)

Usuwa wartość z określonym kluczem z Dictionary<TKey,TValue> i kopiuje element do value parametru.Removes the value with the specified key from the Dictionary<TKey,TValue>, and copies the element to the 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

Parametry

key
TKey

Klucz elementu do usunięcia.The key of the element to remove.

value
TValue

Usunięty element.The removed element.

Zwraca

Boolean

true Jeśli element zostanie pomyślnie znaleziony i usunięty; w przeciwnym razie false .true if the element is successfully found and removed; otherwise, false.

Wyjątki

key to null.key is null.

Dotyczy