Compartilhar via


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

Definição

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

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

Exceções

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.

Aplica-se a