命名规则

命名规则支持遵守 .NET 设计准则 命名约定。

本节内容

规则 描述
CA1700:不要将枚举值命名为“Reserved” 此规则假定当前不使用名称中包含“reserved”的枚举成员,而是将其作为一个占位符,以在将来的版本中重命名或移除它。 重命名或删除成员是一项重大更改。
CA1707:标识符不应包含下划线 根据约定,标识符名称不包含下划线 (_) 字符。 此规则检查命名空间、类型、成员和参数。
CA1708:标识符应以大小写之外的差别进行区分 不能仅通过大小写区分命名空间、类型、成员和参数的标识符,因为针对公共语言运行时的语言不需要区分大小写。
CA1710:标识符应具有正确的后缀 按照约定,扩展某些基类型或实现某些接口的类型的名称或派生自这些类型的类型的名称具有与基类型或接口关联的后缀。
CA1711:标识符不应具有不正确的后缀 根据约定,只有扩展某些基类型或实现某些接口的类型的名称或派生自这些类型的类型应以特定的保留后缀结尾。 其他类型名称不应使用这些保留后缀。
CA1712:不要在枚举值前加上类型名称的前缀 枚举成员的名称不以类型名称为前缀,因为类型信息应由开发工具提供。
CA1713:事件不应具有 before 或 after 前缀 事件的名称以“Before”或“After”开头。 若要命名在特定序列中引发的相关事件,请使用当前或过去时态来指示作序列中的相对位置。
CA1714:Flags 枚举应采用复数形式的名称 公共枚举具有 System.FlagsAttribute 属性,其名称不以“s”结尾。 使用 FlagsAttribute 标记的类型具有复数的名称,因为该属性指示可以指定多个值。
CA1715:标识符应具有正确的前缀 外部可见接口的名称不以大写“I”开头。 外部可见类型或方法上的泛型类型参数的名称不以大写“T”开头。
CA1716:标识符不应与关键字匹配 命名空间名称或类型名称与编程语言中的保留关键字匹配。 命名空间和类型的标识符不应与面向公共语言运行时的语言定义的关键字匹配。
CA1717:只有 FlagsAttribute 枚举应采用复数形式的名称 命名约定规定,枚举的名称使用复数形式表示可以同时指定多个枚举值。
CA1720:标识符不应包含类型名称 外部可见成员中的参数的名称包含数据类型名称,或者外部可见成员的名称包含特定于语言的数据类型名称。
CA1721:属性名称不应与 get 方法匹配 公共或受保护成员的名称以“Get”开头,且其余部分与公共或受保护属性的名称匹配。 “Get”方法和属性应具有清晰区分其功能的名称。
CA1724:类型名称不应与命名空间名称相同 类型名称不应与 .NET 命名空间的名称匹配。 违反此规则可以减少库的可用性。
CA1725:参数名称应与基声明匹配 以一致的方式命名重写层次结构中的参数可以提高方法重写的可用性。 派生方法中的参数名称与基声明中的名称不同,可能会导致混淆方法是替代基方法还是方法的新重载。
CA1727:将 PascalCase 用于已命名占位符 在日志记录消息模板中将 PascalCase 用于已命名占位符。