c#如何实现自定义集合_c#自定义集合项目实例附完整源码

首页

编程语言

热心网友

转载

2026-04-15

C#自定义集合开发指南：为何应优先继承Collection而非手动实现接口

c#如何实现自定义集合_c#自定义集合项目实例附完整源码

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

在C#开发中，创建自定义集合类是一个常见需求。本文将深入探讨一个高效且安全的实现方案：优先继承Collection基类，而非手动实现IEnumerable或IList接口。这一选择能显著提升开发效率，确保数据绑定兼容性，并降低代码维护成本。

避免直接实现`IEnumerable`的三大理由

许多开发者初次尝试创建自定义集合时，会从实现IEnumerable接口开始。然而，这种方法存在几个根本性缺陷：

首先，IEnumerable仅定义了枚举遍历能力，不包含任何集合修改功能。这意味着您需要额外实现Add、Remove、Count等核心成员，工作量远超预期。

其次，LINQ扩展方法（如Where、Select）会返回新的IEnumerable实例，导致自定义集合的业务规则（如数据验证）在链式调用中丢失。

IEnumerable本质上是只读遍历协议，不提供集合修改能力
手动实现完整IList需要重写超过20个成员，极易遗漏关键方法
WPF/WinForms数据绑定机制依赖INotifyCollectionChanged接口，仅实现IEnumerable会导致UI无法自动更新

利用`Collection`基类快速构建业务集合

Collection是.NET框架专门为自定义集合开发设计的可扩展基类。其核心优势在于：

它将所有集合操作拆分为独立的可重写虚方法：InsertItem、RemoveItem、SetItem和ClearItems。开发者只需重写需要添加业务逻辑的方法，其余功能由基类自动处理。

以下示例展示如何创建“仅接受正整数”的自定义集合：

public class PositiveIntCollection : Collection
{
    protected override void InsertItem(int index, int item)
    {
        if (item <= 0) throw new ArgumentException("只允许添加正整数");
        base.InsertItem(index, item);
    }
protected override void SetItem(int index, int item)
{
    if (item <= 0) throw new ArgumentException("只允许设置正整数");
    base.SetItem(index, item);
}
}

自动获得完整的枚举器实现，支持foreach遍历和所有LINQ操作
所有修改入口（Add、Insert、索引器赋值）均被统一拦截，确保业务规则一致性
可轻松扩展集合变更通知机制，支持日志记录或UI自动刷新


手动实现IList的适用场景与风险
虽然继承基类是最佳实践，但在特定场景下仍需手动实现接口：
1. 性能关键型数据结构：如固定大小的环形缓冲区、内存池等需要极致性能的场景
2. 特殊内存布局需求：如将集合直接映射到非托管内存或特定数组结构
一个常见误区是试图通过IList实现“智能过滤”集合。例如，创建自动跳过null元素的列表会遇到语义矛盾：Count属性应返回总长度还是非空元素数？索引器this[0]应返回第一个元素还是第一个非空元素？

IList契约要求Count属性必须为O(1)时间复杂度
索引器必须直接访问物理位置元素，不能动态过滤后重新编排索引
过滤需求应使用LINQ的Where方法，而非修改集合基础语义


完整实战示例：带唯一性约束的排序集合
以下是一个可直接使用的C#自定义集合实现，兼具元素唯一性和自动排序功能：
public class SortedUniqueIntCollection : Collection
{
    private readonly SortedSet _inner = new();
public override int Count => _inner.Count;
protected override void InsertItem(int index, int item)
{
    if (_inner.Add(item)) base.InsertItem(index, item);
    else throw new InvalidOperationException($"重复值 {item} 不允许插入");
}
protected override void RemoveItem(int index)
{
    _inner.Remove(this[index]);
    base.RemoveItem(index);
}
protected override void ClearItems() {
    _inner.Clear();
    base.ClearItems();
}
}
重要说明：此实现使用SortedSet辅助集合来维护唯一性和快速查找，但实际数据存储仍在基类的Items属性（List类型）中。因此，foreach遍历顺序为插入顺序，而非排序顺序。
若需要严格按排序顺序遍历，建议封装SortedSet并实现IEnumerable和IReadOnlyList接口。这一设计决策对集合行为有重要影响，应在项目初期明确需求。