CA1711：标识符应采用正确的后缀

类型名	IdentifiersShouldNotHaveIncorrectSuffix
CheckId	CA1711
类别	Microsoft.Naming
是否重大更改	是

原因

某标识符具有错误的后缀。

规则说明

按照约定，只有扩展某些基类型或实现某些接口的类型的名称或者从这些类型派生的类型的名称，应该以特定的保留后缀结尾。 其他类型名称不应使用这些保留的后缀。

下表列出了保留后缀以及与这些保留后缀关联的基类型和接口。

后缀	基类型/接口
特性	System.Attribute
Collection	System.Collections.ICollection System.Collections.IEnumerable System.Collections.Queue System.Collections.Stack System.Collections.Generic.ICollection<T> System.Data.DataSet System.Data.DataTable
Dictionary	System.Collections.IDictionary System.Collections.Generic.IDictionary<TKey, TValue>
EventArgs	System.EventArgs
EventHandler	事件处理程序委托。
异常	System.Exception
权限	System.Security.IPermission
Queue	System.Collections.Queue
堆栈	System.Collections.Stack
流	System.IO.Stream

另外，不应使用下列后缀：

• 委托

• Enum

• Impl - 改用“Core”

• Ex 或类似后缀，用于区别于同一类型的早期版本

命名约定为所有针对公共语言运行时的库提供了通用的外观。 这提高了学习新软件库的效率，并使客户进一步认为该软件库是由某位具有开发托管代码专门技术的人员所开发。

如何解决冲突

将后缀从类型名称中移除。

何时禁止显示警告

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

相关规则

CA1710：标识符应具有正确的后缀

请参见

参考

Attribute Usage Guidelines

其他资源

事件和委托