Dictionary<TKey,TValue>.TryAdd(TKey, TValue) Método

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Origem:

Dictionary.cs

Tenta adicionar a chave e o valor especificados ao dicionário.

public:
 bool TryAdd(TKey key, TValue value);

public bool TryAdd (TKey key, TValue value);

member this.TryAdd : 'Key * 'Value -> bool

Public Function TryAdd (key As TKey, value As TValue) As Boolean

Parâmetros

key

TKey

A chave do elemento a ser adicionada.

value

TValue

O valor do elemento a ser adicionado. Pode ser null.

Retornos

Boolean

true se o par chave/valor foi adicionado ao dicionário com êxito; caso contrário, false.

Exceções

ArgumentNullException

key é null.

Comentários

Ao contrário do Add método , esse método não gerará uma exceção se o elemento com a chave fornecida existir no dicionário. Ao contrário do indexador Dictionary, TryAdd não substituirá o elemento se o elemento com a chave fornecida existir no dicionário. Se a chave já existir, TryAdd não fará nada e retornará false.