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

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

來源:

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回 。