在 C# 中，集合用于存储和管理对象组。根据是否支持泛型（Generic），主要分为两大类：

• 泛型集合 (``System.Collections.Generic``): 安全、高效，推荐使用。如 ``List<T>``, ``Dictionary<TKey, TValue>``。
• 非泛型集合 (``System.Collections``): 存储 ``object`` 类型，涉及装箱拆箱，性能较差，主要用于兼容旧代码。如 ``ArrayList``, ``Hashtable``。

``List<T>`` 是 C# 中最常用的集合，它本质上是一个大小可变的数组。

在使用 List 之前，必须引用以下命名空间：

using System.Collections.Generic;

声明 List 时必须指定数据类型（T）。

// 1. 声明并实例化一个空的 List
List<int> list1 = new List<int>();
 
// 2. 使用集合初始化器 (声明时直接赋值)
var list2 = new List<int>() { 1, 2, 3, 5, 8, 2, 4 };
 
// 3. 添加元素演示
List<int> list = new List<int>();
list.Add(2); // 索引 0
list.Add(2); // 索引 1
list.Add(3); // 索引 2
 
// 4. 读取与计算
int k = 8;
int b;
Console.WriteLine(list[2] + k);      // 输出 11 (3 + 8)
Console.WriteLine(b = list[0]);      // 输出 2
Console.WriteLine(b = list[0] + list[1]); // 输出 4 (2 + 2)

假设 ``var list = new List<int>();``

逻辑示例：安全添加

if (!list.Contains(5)) // 如果列表中没有 5
{
    list.Add(5); // 则添加 5
}
else
{
    // MessageBox.Show("已经有了"); // WinForms 环境
    Console.WriteLine("已经有了");
}

方式 A：foreach 循环 (推荐)

List<string> list_data = new List<string> { "A", "B", "C" };
 
// 假设在 WinForms 中有一个 listBox1
foreach (string item in list_data)
{
    // listBox1.Items.Add(item);
    Console.WriteLine(item);
}

static void Main(string[] args)
{
    var list = new List<int>();
    list.Add(8);
    list.Add(2);
    list.Add(3);
 
    double avg = CalculateAverage(list);
    Console.WriteLine("平均值: " + avg);
}
 
static double CalculateAverage(List<int> kar)
{
    double sum = 0;
 
    foreach (var item in kar)
    {
        sum = sum + item;
    }
 
    // 注意：kar.Count 是 int，sum 是 double，除法结果为 double
    if (kar.Count == 0) return 0;
    return sum / kar.Count;
}

``ArrayList`` 属于 ``System.Collections`` 命名空间。它是非泛型的，可以存储任意类型的元素（混合存储），但在现代开发中不推荐使用，因为它存在装箱拆箱的性能损耗且类型不安全。

using System.Collections; // 必须引用
 
// 1. 创建空对象
ArrayList listdd = new ArrayList();
listdd.Add("Hello");
listdd.Add(123); // 混合类型
 
// 2. 使用构造函数从现有数组创建
int[] reey = new int[] { 1, 2, 3, 4, 5, 6 };
ArrayList list = new ArrayList(reey);

用法与 ``List<T>`` 极其相似，但参数通常是 ``object``。 * ``Add(object value)`` * ``Insert(int index, object value)`` * ``Remove(object obj)``

``Hashtable`` 用于存储键值对 (Key-Value)。它也是非泛型的，Key 和 Value 都是 ``object`` 类型。

Hashtable HaXi = new Hashtable();
 
// 方式 1：使用 Add 方法
HaXi.Add(1, 2);
HaXi.Add(2, 2.56);
HaXi.Add(3, false);
HaXi.Add(4, "你好");
HaXi.Add("ID", "BH0021"); // Key 也可以是字符串
 
// 方式 2：使用索引器 (如果 Key 不存在则添加，存在则替换/更新)
HaXi[7] = 2.56;
HaXi[1] = 99; // 将 Key 为 1 的值更新为 99

// 移除
HaXi.Remove(6); // 根据 Key 移除
 
// 判断 Key 是否存在
if (!HaXi.ContainsKey(2))
{
    HaXi[2] = 9888;
}
 
// 判断 Value 是否存在
bool hasValue = HaXi.ContainsValue("你好");
 
// 清空
HaXi.Clear();

由于 Hashtable 是无序的，通常遍历 ``Keys`` 或 ``Values``，或者遍历 ``DictionaryEntry``。

// 遍历所有的 Key
foreach (var key in HaXi.Keys)
{
    // 通过 Key 获取 Value
    string content = "Key: " + key + " Value: " + HaXi[key];
    Console.WriteLine(content);
}

int[] reey = new int[] { 1, 2, 3, 4, 5, 6 };
Hashtable haxi = new Hashtable();
 
// 将数组索引作为 Key，数组元素作为 Value
for (int i = 0; i < reey.Length; i++)
{
    haxi[i] = reey[i];
}

``Dictionary`` 是现代 C# 开发中存储键值对的首选。它比 Hashtable 更快、更安全。

// 键是 int，值是 string
Dictionary<int, string> dict = new Dictionary<int, string>();
 
// 初始化器语法
var dict2 = new Dictionary<int, string>()
{
    { 1, "One" },
    { 2, "Two" }
};

// 1. 添加 (Add 方法如果 Key 已存在会报错)
dict.Add(3, "Three");
 
// 2. 更新/添加 (索引器更安全，不存在则添加，存在则覆盖)
dict[1] = "New Value";
 
// 3. 删除
dict.Remove(1); // 删除 Key 为 1 的项
dict.Clear();   // 清空
 
// 4. 安全查找 (重要！)
// 直接访问 dict[99] 如果 Key 不存在会抛出异常
if (dict.ContainsKey(1))
{
    Console.WriteLine(dict[1]);
}
 
// 推荐：TryGetValue (尝试获取，返回 bool，值存入 out 参数)
string value;
if (dict.TryGetValue(1, out value))
{
    Console.WriteLine("获取成功: " + value);
}
else
{
    Console.WriteLine("Key 不存在");
}

// 1. 遍历键值对 (KeyValuePair)
foreach (KeyValuePair<int, string> pair in dict)
{
    Console.WriteLine("Key: " + pair.Key + ", Value: " + pair.Value);
}
 
// 2. 仅遍历键
foreach (int key in dict.Keys) { /*...*/ }
 
// 3. 仅遍历值
foreach (string val in dict.Values) { /*...*/ }

如果在多线程环境下需要频繁操作字典，推荐使用 ``ConcurrentDictionary``。

* 命名空间: ``System.Collections.Concurrent`` * 特点: 它是线程安全的字典实现，不需要手动加锁 (lock)，性能优于手动锁定的 Dictionary。

using System.Collections.Concurrent;
 
ConcurrentDictionary<int, string> conDict = new ConcurrentDictionary<int, string>();
conDict.TryAdd(1, "Value1"); // 线程安全的添加