C#如何提示方法的IDictionary参数仅会被读取、不会被修改？

以下几种方式可以同时使用，既不限制参数类型，又能明确传递只读约定：

• 使用[ReadOnly]特性标记参数
  引用System.ComponentModel命名空间后，直接为参数添加该特性，主流IDE（Visual Studio、Rider等）会自动识别元数据，在调用时提示该参数仅作读取使用，不会被修改。参数类型仍为IDictionary，调用方可以传入任意实现了该接口的类型。
  代码示例：

  using System.ComponentModel;
  
  public void MyMethod([ReadOnly] IDictionary dictionary)
  {
      // 仅执行读取逻辑
  }
  

• 补充XML注释明确说明
  无需依赖任何工具支持，所有调用方都可以通过悬停方法/参数看到约定说明，是兼容性最高的提示方式。
  代码示例：

  /// <summary>
  /// 从字典中读取数据完成业务计算
  /// </summary>
  /// <param name="dictionary">数据源字典，当前方法不会执行添加、修改、删除元素等任何修改操作</param>
  public void MyMethod(IDictionary dictionary)
  {
      // 业务逻辑
  }
  

• 搭配[Pure]特性标记方法
  引用System.Diagnostics.Contracts命名空间后，为方法添加[Pure]特性，表明该方法是无副作用的纯方法，不会修改任何传入参数的状态，静态分析工具会基于该特性给出对应的提示。
  代码示例：

  using System.Diagnostics.Contracts;
  
  [Pure]
  public void MyMethod(IDictionary dictionary)
  {
      // 业务逻辑
  }
  

• 内部包装只读视图避免误修改
  如果需要从实现层面确保方法内部不会意外修改传入的字典，可以在方法内部将传入的字典包装为只读视图，对外参数定义完全不变，不影响调用方传参。
  代码示例：

  public void MyMethod(IDictionary dictionary)
  {
      // 将传入的字典转换为只读视图，后续内部逻辑仅操作该视图即可避免误改
      var readOnlyDictionary = new ReadOnlyDictionary<object, object>(
          dictionary.Cast<DictionaryEntry>().ToDictionary(entry => entry.Key, entry => entry.Value)
      );
      // 后续仅读取readOnlyDictionary的内容即可
  }
  

内容的提问来源于stack exchange，提问作者user3310334