Dictionary<TKey,TValue>.TryAdd(TKey, TValue) 方法

定义

命名空间:

System.Collections.Generic

程序集:

System.Collections.dll

Source:

Dictionary.cs

尝试将指定的键和值添加到字典中。

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

参数

key

TKey

要添加的元素的键。

value

TValue

要添加的元素的值。 它可能是 null。

返回

Boolean

如果成功将键/值对添加到字典中，则为 true；否则为 false。

例外

ArgumentNullException

key 为 null。

注解

Add与 方法不同，如果字典中存在具有给定键的元素，此方法不会引发异常。 与 Dictionary 索引器不同， TryAdd 如果字典中存在具有给定键的元素，则 不会重写 元素。 如果该键已存在，则 TryAdd 不执行任何操作并返回 false。