Condividi tramite


Dictionary<TKey,TValue>.Remove Metodo

Definizione

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
Origine:
Dictionary.cs
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

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

Eccezioni

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

Si applica a

Remove(TKey, TValue)

Origine:
Dictionary.cs
Origine:
Dictionary.cs
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

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

Eccezioni

key è null.

Si applica a