C# | Dictionary.Add()方法

在C#中，Dictionary是一种键值对集合类型，用于存储一组关联的键和值。Dictionary中的项采用泛型类型，可以存储任何不同类型的键和值。

Dictionary.Add()方法用于向Dictionary中添加新的键值对。在添加时，需要指定键和值的类型，否则编译器将无法确定哪些类型是允许的。

语法

以下是Dictionary.Add()方法的语法：

public void Add(TKey key, TValue value);

其中，TKey是指字典中键的类型，TValue是指字典中值的类型。

示例

以下示例展示了如何使用Dictionary.Add()方法向字典中添加新的键值对。

using System;
using System.Collections.Generic;

class Program 
{
    static void Main() 
    {
        // 创建一个Dictionary
        Dictionary<int, string> dict = new Dictionary<int, string>();

        // 向字典中添加新的键值对
        dict.Add(1, "One");
        dict.Add(2, "Two");
        dict.Add(3, "Three");

        // 显示字典中所有的项
        foreach (KeyValuePair<int, string> kvp in dict) 
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value);
        }
    }
}

// 输出结果：
// Key = 1, Value = One
// Key = 2, Value = Two
// Key = 3, Value = Three

补充说明

在使用Dictionary.Add()方法时，需要注意以下几点：

• 如果键已经存在，则会引发ArgumentException异常。
• 如果Dictionary是只读的，则会引发NotSupportedException异常。
• 如果键或值为null，则会引发ArgumentNullException异常。

因此，在使用Dictionary.Add()方法时，应该保证键是唯一的，并且键和值都不为null。

除此之外，还可以使用Dictionary.ContainsKey()方法判断一个键是否已经存在于字典中。在某些场景中，可以避免出现重复的键。