CA1713:事件不应具有 before 或 after 前缀

  • 项目
属性 值
规则 ID CA1713
标题 事件不应具有 before 或 after 前缀
类别 命名
修复是中断修复还是非中断修复 重大
在 .NET 8 中默认启用 否

原因

事件的名称以“Before”或“After”开头。

规则说明

事件名称应描述引发该事件的操作。 若要命名按特定顺序引发的相关事件，请使用现在时或过去时指示一系列操作中的相对位置。 例如，在对关闭资源时引发的一对事件进行命名时，可将其命名为“Closing”和“Closed”，而不是“BeforeClose”和“AfterClose”。

命名约定为面向公共语言运行时的库提供通用外观。 这缩短了新软件库的学习曲线，让客户更加相信该库是由拥有托管代码开发专业知识的人员开发的。

如何解决冲突

从事件名称中删除前缀，并考虑更改该名称，使用谓词的现在时或过去时。

何时禁止显示警告

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