C# Hashtable 详解：键值存储、核心操作与实战示例

什么是 C# Hashtable？

Hashtable 是非泛型集合，以键值对存储数据。不同于数组或列表每个索引仅存单值，哈希表允许通过唯一键直接检索值，提供 O(1) 平均查找时间。

典型条目如下：

{ "001", ".Net" }
{ "002", "C#" }
{ "003", "ASP.Net" }

此处键为 "001"、"002"、"003"，对应值为 ".Net"、"C#"、"ASP.Net"。

下面深入讲解 Hashtable 最常用操作。

声明 Hashtable

用 Hashtable 类型和 new 关键字实例化：

Hashtable ht = new Hashtable();

添加元素

用 Add 方法插入键值对。键和值都必须提供：

ht.Add("001", ".Net");
ht.Add("002", "C#");
ht.Add("003", "ASP.Net");

示例 1 – 显示所有值

下面控制台应用演示创建哈希表、填充并打印每个值：

using System;
using System.Collections;
namespace DemoApplication {
    class Program {
        static void Main(string[] args) {
            Hashtable ht = new Hashtable();
            ht.Add("001", ".Net");
            ht.Add("002", "C#");
            ht.Add("003", "ASP.Net");
            ICollection keys = ht.Keys;
            foreach (String k in keys) {
                Console.WriteLine(ht[k]);
            }
            Console.ReadKey();
        }
    }
}

解析

1. 声明 Hashtable 变量 ht。
2. 用 Add 添加键值对。
3. 通过 ht.Keys 获取键集合（返回 ICollection）。
4. 遍历键并用 ht[key] 输出关联值。

运行程序输出：

常用方法

ContainsKey

检查特定键是否存在：

ht.ContainsKey("001"); // 键存在返回 true

ContainsValue

验证特定值是否存储在哈希表中：

ht.ContainsValue("C#"); // 找到值返回 true

示例 2 – 使用 ContainsKey & ContainsValue

下面简短程序演示两方法：

using System;
using System.Collections;
namespace DemoApplication {
    class Program {
        static void Main(string[] args) {
            Hashtable ht = new Hashtable();
            ht.Add("001", ".Net");
            ht.Add("002", "C#");
            ht.Add("003", "ASP.Net");
            Console.WriteLine(ht.ContainsKey("001")); // true
            Console.WriteLine(ht.ContainsValue("C#")); // true
            Console.ReadKey();
        }
    }
}

解析

1. ContainsKey 确认 "001" 存在。
2. ContainsValue 确认 "C#" 存储。

控制台显示：

关键要点

Hashtable 以键值对存储元素，知键时可快速查找。现代 C# 推荐泛型 Dictionary<TKey, TValue> 保证类型安全，但理解 Hashtable 对遗留代码和互操作场景仍有价值。