Dictionary<TKey,TValue>.Remove Método

Origem:

Dictionary.cs

Origem:

Dictionary.cs

Origem:

Dictionary.cs

Origem:

Dictionary.cs

Origem:

Dictionary.cs

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

Parâmetros

Retornos

true se o elemento for encontrado e removido com êxito; caso contrário, false. Esse método retornará false se key não for encontrado no Dictionary<TKey,TValue>.

Implementações

Exceções

Exemplos

O exemplo de código a seguir mostra como remover um par chave/valor de um dicionário usando o Remove método.

Este exemplo de código faz parte de um exemplo maior fornecido para a Dictionary<TKey,TValue> classe (openWith é o nome do Dicionário usado neste exemplo).

// 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.
printfn "\nRemove(\"doc\")"
openWith.Remove "doc" |> ignore

if openWith.ContainsKey "doc" |> not then
    printfn "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

Comentários

Se o Dictionary<TKey,TValue> elemento não contiver um elemento com a chave especificada, ele Dictionary<TKey,TValue> permanecerá inalterado. Nenhuma exceção é gerada.

Esse método se aproxima de uma operação O(1).

Somente .NET Core 3.0+: esse método de mutação pode ser chamado com segurança sem invalidar enumeradores ativos na Dictionary<TKey,TValue> instância. Isso não implica segurança de thread.

Confira também

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

Origem:

Dictionary.cs

Origem:

Dictionary.cs

Origem:

Dictionary.cs

Origem:

Dictionary.cs

Origem:

Dictionary.cs

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

Parâmetros

Retornos

true se o elemento for encontrado e removido com êxito; caso contrário, false.

Exceções