Dictionary<TKey,TValue>.Remove Metodo

Definizione

Spazio dei nomi:

System.Collections.Generic

Assembly:

System.Collections.dll

Overload

Remove(TKey)	Rimuove il valore con la chiave specificata dall'insieme Dictionary<TKey,TValue>.
Remove(TKey, TValue)	Rimuove il valore con la chiave specificata da Dictionary<TKey,TValue> e copia l'elemento nel parametro value.

Remove(TKey)

Origine:

Dictionary.cs

Rimuove il valore con la chiave specificata dall'insieme 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

Parametri

key

TKey

Chiave dell'elemento da rimuovere.

Restituisce

Boolean

true se l'elemento viene trovato e rimosso; in caso contrario, false. Questo metodo restituisce anche false se key non viene trovato in Dictionary<TKey,TValue>.

Implementazioni

Remove(TKey)

Eccezioni

ArgumentNullException

key è null.

Esempio

Nell'esempio di codice seguente viene illustrato come rimuovere una coppia chiave/valore da un dizionario usando il Remove metodo .

Questo esempio di codice fa parte di un esempio più grande fornito per la Dictionary<TKey,TValue> classe (openWith è il nome del dizionario usato in questo esempio).

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

Commenti

Se l'oggetto Dictionary<TKey,TValue> non contiene un elemento con la chiave specificata, il Dictionary<TKey,TValue> valore rimane invariato. Non viene generata alcuna eccezione.

Questo metodo si avvicina a un'operazione O(1).

Solo .NET Core 3.0+ : questo metodo di modifica può essere chiamato in modo sicuro senza invalidare gli enumeratori attivi nell'istanza Dictionary<TKey,TValue> . Questo non implica la sicurezza dei thread.

Vedi anche

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

Remove(TKey, TValue)

Origine:

Dictionary.cs

Rimuove il valore con la chiave specificata da Dictionary<TKey,TValue> e copia l'elemento nel parametro 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

Parametri

key

TKey

Chiave dell'elemento da rimuovere.

value

TValue

Elemento rimosso.

Restituisce

Boolean

true se l'elemento viene trovato e rimosso; in caso contrario, false.

Eccezioni

ArgumentNullException

key è null.