CA2201:不要引发保留的异常类型

  • 项目
属性 值
规则 ID CA2201
标题 不要引发保留的异常类型
类别 使用情况
修复是中断修复还是非中断修复 重大
在 .NET 8 中默认启用 否

原因

方法引发的异常类型太过笼统，或已由运行时保留。

规则说明

以下异常类型太过笼统，无法为用户提供足够的信息：

以下异常类型已保留，仅应由公共语言运行时引发：

请勿引发一般异常

如果在库或框架中引发一般异常类型，如 Exception 或 SystemException，将强制使用者捕捉所有异常，包括不知该如何处理的未知异常。

相反，要么引发框架中已存在的派生程度更高的类型，要么创建自己从 Exception 派生的类型。

引发特定异常

下表显示了要为各种类型的无效参数引发的异常，包括属性的 set 访问器中的值参数。

参数无效 例外
null 参考 ArgumentNullException
超出允许的值（如集合或列表的索引）范围 ArgumentOutOfRangeException
enum 值无效 InvalidEnumArgumentException
包含不满足方法参数规范的格式（如适用于 ToString(String) 格式字符串） FormatException
否则无效 ArgumentException

下表显示了要为各种类型的无效操作引发的异常。

操作无效 异常
操作对对象的当前状态无效。 InvalidOperationException
操作在已释放的对象上执行。 ObjectDisposedException
操作不受支持（例如，在因读取而打开的 Stream 中重写 Stream.Write）。 NotSupportedException
转换将导致溢出（例如，显式强制转换运算符重载）。 OverflowException

对于所有其他情况，请考虑创建自己的从 Exception 派生的类型，并将其引发。

如何解决冲突

要解决此规则的冲突，请将引发的异常类型更改为特定类型，此特定类型不属于保留的类型。

何时禁止显示警告

不禁止显示此规则发出的警告。