在C#中,Dictionary<TKey, TValue>
是一个集合,它存储的是键值对(key-value pairs)的集合。每个元素都是一个键值对,其中的键是唯一的,并且每个键都映射到其关联的值。字典非常适用于需要通过键快速检索值的情况。
创建一个Dictionary
你可以使用下面的语法来创建一个Dictionary
:
Dictionary<TKey, TValue> myDictionary = new Dictionary<TKey, TValue>();
其中,TKey
是键的类型,TValue
是值的类型。这两个类型都是泛型参数,可以根据你的需求指定为任何类型。
添加元素
你可以使用Add
方法或集合初始化器来向Dictionary
中添加元素:
// 使用Add方法
myDictionary.Add("apple", 100);
myDictionary.Add("banana", 200);
// 使用集合初始化器
Dictionary<string, int> fruits = new Dictionary<string, int>
{
{"apple", 100},
{"banana", 200}
};
访问元素
你可以通过键来访问或修改对应的值:
// 访问值
int appleCount = myDictionary["apple"];
// 修改值
myDictionary["apple"] = 150;
检查键是否存在
在尝试访问一个不存在的键之前,你可能想先检查该键是否存在于字典中。你可以使用ContainsKey
方法来实现这一点:
if (myDictionary.ContainsKey("orange"))
{
// 键存在
}
else
{
// 键不存在
}
遍历Dictionary
你可以使用foreach
循环来遍历字典中的所有键值对:
foreach (KeyValuePair<string, int> kvp in myDictionary)
{
Console.WriteLine($"Key = {kvp.Key}, Value = {kvp.Value}");
}
// 或者使用更简洁的语法(C# 6.0及更高版本)
foreach (var kvp in myDictionary)
{
Console.WriteLine($"Key = {kvp.Key}, Value = {kvp.Value}");
}
移除元素
你可以使用Remove
方法来从字典中移除键值对:
myDictionary.Remove("banana");
注意事项
- 字典中的键必须是唯一的。如果尝试添加一个已经存在的键,则会抛出一个
ArgumentException
异常。 - 字典的存储顺序并不是根据键值对的添加顺序来确定的。如果需要保持元素的添加顺序,可以使用
SortedDictionary<TKey, TValue>
(基于键排序)或OrderedDictionary
(已废弃,但可在System.Collections.Specialized
命名空间中找到,但并非泛型)。从.NET Framework 3.5开始,你还可以使用SortedList<TKey, TValue>
或SortedSet<T>
与自定义逻辑结合来达到有序存储的目的,但对于键值对存储,通常推荐使用SortedDictionary<TKey, TValue>
的泛型版本,特别是在需要排序且键值对数量较大时。在.NET Core和.NET 5/6+中,还可以使用SortedDictionary<TKey, TValue>
或ImmutableDictionary<TKey, TValue>
(如果不需要修改字典)的泛型版本。对于需要频繁访问和添加操作,且关心插入顺序的场景,.NET Core 3.0及以上版本引入的System.Collections.Immutable
命名空间下的ImmutableDictionary<TKey, TValue>
提供了不变集合的支持,这对于多线程环境下的数据共享特别有用。