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

定義

嘗試將指定的索引鍵和值新增至字典。

C#
public bool TryAdd (TKey key, TValue value);

參數

key
TKey

要加入的項目的索引鍵。

value
TValue

要加入的項目的值。 它可以是 null

傳回

若索引鍵/值組已成功新增至字典,即為 true;否則為 false

例外狀況

keynull

備註

Add不同於 方法,如果具有指定索引鍵的專案存在於字典中,這個方法就不會擲回例外狀況。 不同於 Dictionary 索引器,如果具有指定索引鍵的專案存在於字典中, TryAdd 則不會覆寫元素。 如果索引鍵已經存在, TryAdd 則不會執行任何動作並傳 false回 。

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1