我们已经讨论了哈希表的基础知识。 C# 中的哈希表集合用于存储键值对，其中每个键值对都是根据键的哈希码进行组织的。该哈希码是使用哈希码函数计算的。在内部，哈希表使用桶来存储数据。存储桶只不过是哈希表中的一组虚拟元素。哈希码与每个存储桶相关联。
从编程上来说，哈希表类似于字典对象，但与字典对象不同的是，哈希表可以存储不同数据类型的对象。在性能方面，哈希表表现出较低的性能，因为哈希表的数据元素是对象。因此，为了从哈希表中存储和检索值，必须执行对象的装箱和拆箱。
在本文中，我们将讨论如何向哈希表集合添加项目。
如何将项目添加到哈希表集合？
C#中的hashtable集合是使用hashtable类实现的。此类提供了各种方法来对哈希表执行不同的操作。其中一种方法是 Add()。
哈希表类的Add()方法用于在哈希表中添加具有指定键及其对应值的元素。当向哈希表添加键值对时，我们应该确保键不重复或为空，因为哈希表只允许非空且唯一的键。
在C#的哈希表集合中，我们可以拥有不同数据类型的键/值对元素。
现在让我们继续讨论 Add() 方法。
下面给出了哈希表集合的Add()方法的一般原型。
语法
public virtual void Add(object key, object value);
参数
Key - 正在添加的元素的指定键（类型 System.Object）。应为非空。
Value - 元素的指定值（类型 System.Object）此值可以为 null。
异常：此方法抛出以下异常。
ArgumentNullException − 当键为 null 时。
ArgumentException − 具有相同键的元素已存在。
NotSupportedException − 哈希表具有固定大小或只读。
如果我们有一个哈希表对象声明如下 -
Hashtable hshTable = new Hashtable();
然后我们可以使用 Add() 方法向该哈希表对象添加一个元素，如下所示 -
hshTable.Add("msg", "charVal");
由于哈希表允许混合数据类型的元素，因此我们也可以在同一个哈希表中添加数值 -
hshTable.Add(1, 2022);
除了使用 Add() 方法，我们还可以直接将值分配给哈希表。例如，要添加 key = 2 的元素，我们可以简单地编写，
hshTable[3] = "three";
上述语句将在哈希表中创建一个键值对（3，“三”）。
向哈希表集合添加项的编程示例
以下程序演示了如何使用 Add() 方法构建不同元素的哈希表。
示例 1
using System;
using System.Collections;
class Program {
static void Main(string[] args) {
Hashtable mixedHashTable = new Hashtable();
//add method
mixedHashTable.Add("msg", "Collection");
mixedHashTable.Add("site", "HashTable");
mixedHashTable.Add(1, 3.14);
mixedHashTable.Add(2, null);
//assign value to the key
mixedHashTable[3] = "Tutorial";
// Add method throws an exception if the key already exists in //hashtable
try {
mixedHashTable.Add(2, 750);
} catch {
Console.WriteLine("Hashtable already has an element with Key = '2'.");
}
Console.WriteLine("*********HashTable Elements********");
// It will return elements as Key-Value Pair.
foreach (DictionaryEntry elem in mixedHashTable) {
Console.WriteLine("Key = {0}, Value = {1}", elem.Key, elem.Value);
}
Console.ReadLine();
}
}
上面的程序首先使用默认构造函数创建一个哈希表对象。然后它使用 Add() 方法将不同的元素添加到哈希表中。我们还可以通过直接赋值来将元素添加到哈希表中。上面的程序将不同数据类型的键值对添加到哈希表中。然后使用迭代器，将哈希表的元素一一显示出来。
输出
上述示例的输出如下所示 -
Hashtable already has an element with Key = '2'. *********HashTable Elements******** Key = 2, Value = Key = msg, Value = Collection Key = 3, Value = Tutorial Key = site, Value = HashTable Key = 1, Value = 3.14
输出显示了我们添加到哈希表中的所有键值对。
我们再举一个向哈希表添加元素的例子。程序如下。
示例 2
using System;
using System.Collections;
class hTable {
// Driver code
public static void Main() {
// Creating a Hashtable
Hashtable strHashTable = new Hashtable();
// Adding elements in Hashtable
strHashTable.Add("4", "Even Number");
strHashTable.Add("9", "Odd Number");
strHashTable.Add("5", "Odd and Prime Number");
strHashTable.Add("2", "Even and Prime Number");
// Get a collection of the keys.
ICollection c = strHashTable.Keys;
// Displaying the hashtable contents
Console.WriteLine("=========Contents of the Hashtable=========");
foreach(string str in c)
Console.WriteLine(str + ": " + strHashTable[str]);
}
}
在此程序中，我们添加字符串类型的值。我们使用 Add() 方法添加值，然后检索哈希表中的键集合。然后，我们使用 foreach 循环遍历此键集合并显示每个键及其相应的值。
输出
生成的输出如下 -
=========Contents of the Hashtable========= 5: Odd and Prime Number 9: Odd Number 2: Even and Prime Number 4: Even Number
通过这种方式，我们可以使用 hashtable 类的 Add() 方法将项添加到 hashtable 集合中。
我们在本文中了解了如何将项目添加到哈希表集合中。在以后的文章中，我们将讨论更多关于 Hashtable 的操作。
