C#中数组与集合参数传递的防篡改策略

蓝鲸

发布时间：2026-10-13| 5人浏览过

原创

在C#编程中，方法参数的意外修改常引发隐蔽的逻辑错误。由于数组和集合属于引用类型，直接传递可能导致调用者原始数据被破坏。本文通过解析值/引用传递机制，提供基于readonly字段、构造函数封装及IReadOnlyCollection接口的防御性编程方案，帮助开发者从源头保障数据安全。

结果或目标

设计具有高内聚和低耦合特性的C#方法，确保在传递复杂数据结构（如数组、集合）时，即使方法内部发生逻辑变更，也不会意外影响外部调用者的原始数据状态。核心目标是实现数据的“只读”或“不可变”约束。

准备条件

理解C#中的值类型（int, struct等）与引用类型（class, array, list等）的内存存储区别。
掌握基本的数据封装原则：将字段设为私有，通过属性或构造函数暴露访问权限。
使用Visual Studio或其他支持C#的开发环境进行代码编写与调试。

真实操作顺序

第1步：区分参数传递的本质差异

目的：明确何时修改参数会影响原始对象，为后续防护建立理论基础。

入口：C#方法定义与调用处。

动作：分析以下三种概念的区别：

值类型 vs 引用类型：值类型传递的是副本；引用类型传递的是指向堆内存地址的指针。
值传递 vs 引用传递（ref/out）：值传递保护原始引用地址不被重定向；ref或out允许方法内部重新分配对象并影响外部。
传递引用类型参数 vs ref引用类型：这是最容易混淆的点。仅传递引用类型（非ref），如果在方法内修改对象内部的属性/元素，外部会变；但如果重新赋值该参数变量（指向新对象），外部不变。

void FunA(MyClass a)
{
    a = new MyClass("A"); // 创建新对象，原a不受影响
}
void FunB(ref MyClass a)
{
    a = new MyClass("B"); // 重新赋值，原a受影响
}
void Test()
{
    MyClass a = new MyClass("A");
    FunA(a); 
    Console.WriteLine(a); // 输出: A (未变)
    FunB(ref a);
    Console.WriteLine(a); // 输出: B (已变)
}

重要参数：理解“修改内容”与“替换引用”的区别。对于普通引用类型参数，虽然不能替换引用，但可以修改其包含的内部状态（如数组元素）。

第2步：构建不可变的简单数据结构

目的：针对由值类型组成的类或包含其他自定义对象的类，从底层锁定数据。

入口：实体类（Class）定义。

动作：

将所有字段标记为 private readonly。
对应的属性仅提供 get 访问器，移除 set。
所有初始化逻辑必须移至构造函数中完成。

public class SuperClass
{
    private readonly int _no;
    private readonly SubClass _tag;
    
    public int NO { get { return _no; } }
    public SubClass Tag { get { return _tag; } }
    
    public SuperClass(int no, SubClass tag)
    {
        _no = no;
        _tag = tag; 
    }
}

// 嵌套类同样需遵循只读原则
public class SubClass
{
    private readonly int _field;
    public int Field { get { return _field; } }
    
    public SubClass(int field) { _field = field; }
}

可观察的完成状态：尝试在外部或内部修改 _no 或 NO 的属性时将报错，编译失败。

第3步：处理复杂引用类型参数（数组与集合）

目的：解决上述封装无法保护的数组和列表问题，因为即使外层对象只读，其内部的数组元素仍可被修改。

入口：方法签名定义。

动作：

旧版本兼容（.NET 4.5以前）：使用不包含修改方法的接口代替具体类型。例如，传入 IEnumerable<T> 而非 List<T>，利用接口限制只能读取，无法调用 Add/Remove 等方法。
.NET 4.5及以上：优先使用 IReadOnlyCollection<T> 或 IReadOnlyList<T> 作为参数类型。这些接口专门用于表达“只读集合”意图。
数组特殊处理：C#中没有天然的“只读数组”接口能完美阻止对索引赋值（如 arr[0] = 1）。因此，尽量避免使用数组作为方法参数，除非必要场景（如可选参数默认值）。若必须传递数组，考虑在方法内部制作深拷贝（Shallow Copy对于值类型足够，引用类型需注意）进行操作，但最根本的解法是在上游控制数据流。