Dictionary<TKey, TValue> 是 .NET 最常用的鍵值對集合,提供 O(1) 查找效能。本文以 Dictionary<string, string> 為例,快速示範新增、判斷、移除、取值、迴圈等核心操作。
var dic = new Dictionary<string, string>();
dic.Add("01", "aaa");
dic.Add("02", "bbb");
if (!dic.ContainsKey("03"))
dic.Add("03", "ccc");
dic.Remove("03");
string val = dic["02"]; // 可能拋 KeyNotFoundException
// 安全取值
if (dic.TryGetValue("02", out string v))
Console.WriteLine(v);
// 1. 同時取 Key/Value (推薦)
foreach (var kvp in dic)
Console.WriteLine($"{kvp.Key}, {kvp.Value}");
// 2. 僅遍歷 Key
foreach (var k in dic.Keys) { /* ... */ }
// 3. 僅遍歷 Value
foreach (var v in dic.Values) { /* ... */ }
// 取值或預設
string v = dic.GetValueOrDefault("99", "N/A");
// 合併字典 (覆寫相同鍵)
var dic2 = new Dictionary<string, string> { ["02"] = "BBB", ["04"] = "ddd" };
foreach (var kvp in dic2) dic[kvp.Key] = kvp.Value;
Dictionary 非執行緒安全,多執行緒環境請用 ConcurrentDictionary 或自行加鎖。capacity 減少擴容開銷:new Dictionary<int, string>(10000)。